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Preface 


Local area networks such as the Econet represent a milestone in 
the development of microcomputer technology. Acorn Computers 
Ltd of Cambridge, England, are well known for their innovative 
and ambitious designs; not the least of these is the Econet. This 
system has evolved over several years to provide powerful and 
low-cost networking. The company participated in the develop¬ 
ment of the Cambridge Ring which networks large computer 
systems together. They also believed that microcomputer users 
should have this facility. 

I became involved with my first Econet system in early 1981 
while working on the design of another local area network. It was 
very early days for this type of system. Any designer would be 
complimented to find that someone else had the same solution to 
a problem. That is, unless the someone else was doing a better 
job. That is certainly how it was with the Econet. It is a credit to 
the original design that there have been few major changes and 
yet it is still one of the fastest and most effective local networks 
for microcomputers. 

This book began with the modest ambition to produce a useful 
station guide for users of Acorn’s Econet. At the same time. Acorn 
were nearing completion of their official release manuals. For 
three years Econet users have lived with preliminary manuals. 
What computer manuals aren’t preliminary releases? The new 
manuals are well organized with a station manual, an advanced 
system programmers guide, and a system managers guide. What 
was still needed was a book which could describe networking 
from the basics and then explain what, why, and how things 
happen. 



Networking with the BBC Microcomputer is about a computer 
system. In writing this text, I have assumed that the reader has 
some background knowledge of computing or is being assisted by 
a teacher or instructor. It helps new system managers to find 
'why things don’t happen in the way that I think the manual says 
it should’. In this regard, it contains many 'what if situations. 
This will also help other teachers to become self-sufficient. There 
are also many competent students who like to sort things out for 
themselves. This book will help them as well. 

All programming examples use BBC Basic. This book is about 
networking, not about teaching structured programming, how¬ 
ever most examples show that BBC Basic positively encourages 
the design of well-structured programs. None are written in 
machine code. But understanding the structure of the registers in 
the 6502 microprocessor would help when studying operating 
system calls. Material covering the Econet primitives has not 
been included as this is well covered in the Acorn manuals. 

System management and security have not been included (as 
much as I would have liked to), for to do so would jeopardize the 
effectiveness of the system. This does not mean that these topics 
are not important. On the contrary, it is because of their 
importance that they are omitted. If you are a system manager, 
read what is available, talk to other managers and to your 
supplier. The effectiveness of the system depends on the quality 
of its management and on how seriously system security is 
applied. 

Some readers may find material such as the 'Econet Technical 
Description’ and 'Working with Files’ heavy going. These sections 
are included for advanced users. If you are a newcomer to the 
system, be assured that the time will come when you will need 
some of this material. By that time, you may be an advanced user 
too! 

The manuscript of this book was prepared on a BBC Microcom¬ 
puter with a 6502 second processor using Acornsoft’s View word 
processor. Typesetting was performed on an Econet system at The 
Daily Mercury, Mackay, North Queensland. 



I wish to thank Joe Dunn, Brian Robertson and Jez Wills of the 
Econet Project Group at Acorn Computers for their assistance 
and advice. Carl Dellar of Hewlett Packard laid the foundations 
for the file server software while at Cambridge. Paul Bond of 
Topexpress and Roger Wilson of Acorn contributed a great deal to 
the initial design. There are others outside Acorn Computers who 
have contributed to the development of Econet. These include 
Chris Dawkins and Andrew Gordon of Felstedd School in Cam¬ 
bridgeshire, and Kim Spence-Jones of SJ Research in Cambridge. 

There are many people in Australia who have contributed to the 
development of Econet. These are the system managers of the 
many schools and companies who were the first to purchase this 
system. In every sense, they have been pioneers. Worthy of 
special mention are Ralph Leonard of the Angle Park Computing 
Centre in South Australia; David Smith of Melbourne Grammar 
School; Richard Wynd and Frank Goricanec of Williamstown 
Technical School (Vic.); Bevan Leviston of the Institute of 
Catholic Education, Oakleigh Campus (Vic.); Vince Emmerson of 
The Daily Mercury, Mackay, North Queensland; and Brian 
Cockburn of Barson Computers, Melbourne. 

I am indebted to Lynn Gemmell of Prentice-Hall of Australia for 
her patient and professional approach to editing this book. I owe a 
special note of thanks to John Coll of the Microelectronics 
Education Programme in the UK for his assistance and advice on 
so many issues regarding computers in education. I must also 
thank Julian Barson for introducing Econet to me and to 
Australia. 


To Diane, Katherine and Andrew for their patience 
and to SHEILA. 


R.G. NAPIER 
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NETWORKING 
WITH THE BBC 
MICROCOMPUTER 


One of the great technical developments of the 80s has been the 
creation of local, regional and international computer communi¬ 
cation systems using home computers as terminals. Large 
computers have been set up to provide consumer services such as 
electronic mail and information data bases. Previously, these 
services were only available to large organizations. Improved 
satellite and telephone communications plus the falling cost of 
microcomputers have contributed to this development. 

However this text does not address this type of networking. 
Instead, it concentrates on systems called Local Area Networks 
(LANs). A LAN is a group of directly connected computers, 
usually within the same or neighboring buildings. By providing 
computers with a communications medium, this allows them to 
share resources such as disks and printers. They may also share 
information. 

In many countries, the telecommunications authority (the phone 
company) takes a dim view of people using their own cable 
communication systems beyond the boundary of their own 
property. LANs do not use the telephone system. Each computer 
contains electronics which provides the link between the machine 
and a dedicated connecting cable. The electronics is called the 
INTERFACE. Each computer must also contain a program to 


1 



2 


manage the transfer of data to and from the network. In the BBC 
Microcomputer, this is called the NETWORK FILING SYSTEM 
(NFS). 

Every BBC Microcomputer has the potential to be part of a LAN. 
At the rear of the machine, near the power supply, is the section 
of the circuit board where the Econet interface is fitted. You may 
be reading this text because you are using a computer on a 
network or perhaps because you just want to know what this 
facility offers. In either case, we will begin by examining the 
layout of a network and compare it to other types of computer 
systems. 

At the time of writing, there are at least three LANs available for 
the BBC Microcomputer. These are Acorn’s Econet, U-Comput- 
er’s uNET and a system developed by John Ferguson of Paisley 
College, Scotland, called Piconet. Each has its advantages. 

Econet is fast and powerful and may span long distances. One of 
its greatest features is the file server. This is a system which 
stores programs and data for several users on one set of disk 
drives. It allows users to keep their files separate from all other 
users on the system. Normally this facility is available only on 
large systems. 

uNET is a new development which aims to provide a system for 
linking a number of different types of computers (including the 
BBC Microcomputer) together. It makes use of the RS423 
connection, fitted as standard to all Model B machines. This 
network may also cover long distances. However, each computer 
requires a separate cable, unlike the Econet which shares a 
common cable. A great plus for uNET is the excellent documen¬ 
tation supplied with the system. 

Piconet is a low-cost network which connects BBC and Apple 
computers. The BBC Micro uses its parallel user port and the 
Apple uses the games paddle input. This system is restricted to 
short cable lengths, usually in the same room. While it is limited 
in its capabilities, it is useful for small systems, particularly 
where there are already both BBC and Apple computers. 

This text describes only the Econet system. At the time of 
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writing, it has proved reliable in several hundred installations, 
mostly in schools and colleges. The longest operational network 
uses one kilometer of cable. The largest system has more than 60 
stations and there are many sites with over 30 units. In addition 
to classroom networks, there have been a number of innovative 
applications outside education. BBC Microcomputers, connected 
by the Econet, are used at a power station for sophisticated data 
logging. Information about the performance of the electrostatic 
filters which remove coal dust and smoke from the stacks is sent 
to a file server for later processing. A newspaper house has linked 
an Econet system to their mainframe computer for entry of 
classified advertisements, local reporting and linkage to interna¬ 
tional wire services. 

Networking is mainly about direct computer-to-computer com¬ 
munication. Well-designed and reliable systems such as Econet 
offer tremendous scope for new computer applications. For 
example, a group of software engineers is investigating the 
feasibility of using BBC Microcomputers to control the environ¬ 
ment in high-rise buildings. The computers, linked together by 
the Econet, would provide a reliable method of monitoring and 
controlling a building’s air-conditioning plant. 


A BRIEF OVERVIEW 

We will begin with a brief overview of the development of local 
area networks as they evolved from the large multi-terminal, 
mainframe computer systems. The key elements of all computer 
systems (microcomputer, minicomputer and mainframe) are: 

• A central processing unit 

• Main memory for program execution 

• A user input device (e.g. a keyboard) 

• A user output device (e.g. a video display) 

• A hardcopy output device (e.g. a printer) 

• Backing store (e.g. cassette or disk drive) 

The user enters the program from the keyboard and/or some 
backing store. Data to be manipulated by the program is entered 
in the same way. The program and data are stored (if only 
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temporarily) in the computer’s main memory. If the results from 
the program need to be saved for further processing, they may be 
stored as a file in the backing store. If this is not done, the results 
are lost when the power is disconnected from the computer or 
when a new program is loaded. Video terminals allow users to 
view their results quickly. Printers give a 'hard copy’ of the 
results which can be examined when needed. Controlling all of 
this and performing the required task is the Central Processing 
Unit (CPU). In large computer systems, this could consist of one 
printed circuit board or it may be so large that it occupies large 
cabinets, crammed with electronics. In a microcomputer, the 
CPU usually consists of just one integrated circuit. This device 
measures approximately 50 by 15 millimeters. It performs most 
of the jobs that its big brothers (the mini and mainframe 
computers) can, except that it is usually much slower. 

In the BBC Microcomputer, the CPU is a 6502 microprocessor. A 
module can be connected to the main system which contains extra 
memory and a second CPU (another 6502 or a Z80 microproces¬ 
sor). In this arrangement, the two computers communicate via a 
link called the Tube. The BBC Microcomputer looks after all 
INPUT/OUTPUT (PO) operations while the SECOND PROCES¬ 
SOR (or CO-PROCESSOR) runs the user’s program. Whenever 
the program requests access to some external device, it is 
processed by the BBC Microcomputer, under instructions from 
the second processor (via the Tube). 



Figure 1.2 BBC Microcomputer with co-processor 





THE TIME-SHARE COMPUTER 

In the case of very large systems, it is common for several users to 
share the same computer. Users have their own terminals (for 
input and output) and their programs share the central computer 
and its memory. Since the computer can execute programs very 
quickly, it appears to the user that only his or her program is 
being executed. This is done by spending a small amount of time 
(a fraction of a second) performing a part of each user’s task 
before moving on to the next one. 

Such computer systems usually have huge amounts of main 
memory and backing store. The main memory is divided up with 
each user being given a section for use by their own program. In 



Figure 1.3 A multi-user (or time-share) system 
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addition, the computer needs a large amount of memory to run 
the program which looks after the users’ programs (the operating 
system). Multi-user systems are complex and expensive. The 
approach is to build super computers which many users can share 
via the terminals. They share main memory and backing store, as 
well as printers and other specialized devices. Each video 
terminal usually has little (if any) 'intelligence’; that is, it is not a 
computer. 


THE LOCAL AREA NETWORK 

With the development of the microcomputer, the demand for 
large centralized computer systems dropped. While there are still 
tasks which are best performed by mainframe computers, there is 
a strong push for 'distributed processing’; that is, a system where 
the computing is done by a number of independent computers, 
linked in some way. Since microprocessor and memory devices 
are inexpensive, we can now afford to make each user’s terminal 
a computer in its own right. It is this development which has 
allowed the birth of the personal computer. So far we have talked 
about sharing the computer’s central processor and main mem¬ 
ory. These devices have become cheap with mass production 
techniques. There are other components (such as disk drives and 
printers) which are still relatively expensive. There are sound 
economic reasons for sharing these facilities. 

Why is it impractical to use microcomputers for time-sharing 
with multiple terminals? Since the microprocessor is a scaled- 
down version of the CPU in large systems, there is no technical 
reason why they can’t. (In fact, such systems do exist!) The reason 
why they have not become popular is that they are much slower 
than their bigger brothers. Also, since the components are so 
inexpensive, there is little reason to design systems in that way. 

Consider the case where a chess master plays an exhibition 
match against 20 or 30 players. The master makes one move and 
then moves on to the next player. Since he can decide what move 
to make very quickly, he can circulate around the group in the 
time that an average player would take to make one move. If a 
novice tried to play the same match, the group would become 
bored waiting for their next move. Like the novice, multi-user 
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systems using a microcomputer are unsuccessful because the 
central processor is not fast enough to process several programs 
simultaneously. 

Now consider a computer system where there are many micro¬ 
computers (each with its own keyboard and display) sharing disk 
storage and a printer. Such a system is called a Local Area 
Network. Each user has his or her own microcomputer, working 
independently of the rest. It doesn’t matter that the central 
processor is not as powerful as large mainframe computers since 
it only needs to look after one user. We shall call these micro¬ 
computers WORKSTATIONS. 

If one computer were employed to do nothing but control the 
operation of the disk system, it could easily look after the task of 
saving and loading programs and data for several users. This is 
called the FILE SERVER. Similarly, we would need another 
computer to manage the task of printing information for all of the 
users on the system. This is called the PRINTER SERVER. 

There are obvious economic benefits in sharing expensive 
hardware such as disks and printers. There is another object 
which may be shared on local area networks which has previous¬ 
ly only been available to time-share computers. This is the 
sharing of data (information). Imagine ten users, sitting at ten 
microcomputers, disk drives and printers. If all the users were 
performing the same task, and accessing the same information, 
stored as identical data files on the ten disk drives, it would be 
unworkable. Each time a user changed any item in a file, it would 
have to be updated on all other disk drives. 

Since the Econet file server allows multi-user access to its files, 
we can set up common data files which may be accessed by all 
users of the network. A good example of a shared data base is an 
airline booking system. All flight information is stored in one 
system, continuously accessed by operators from all over the 
country. It is a distributed processing system using large 
centralized computers, usually with smaller machines in regional 
centers. Each time a booking is made or changed, the data is 
recorded on disk at the central computer. In such systems, a 
change to a flight booking affects many areas; for example, seat 
availability, in-flight catering and flight planning. Thus many 
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parts of the organization benefit by sharing a common data base. 
In addition, the friend waiting for you in another city may wish to 
know if you caught your flight. There are many examples of 
systems which benefit by sharing data bases. We could create a 
model of the airline booking system using the Econet with each 
workstation performing the role of an operator’s terminal. 



Flight Planning 

Figure 1.4 A model of an airline booking system 
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ECONET INTERFACE AND SYSTEM SOFTWARE 

So far, local networks have been described as computers which 
are linked together to share expensive resources and information 
of common interest. For this system to function, there are two 
more elements needed. The first is the electronics to link the 
computer systems (the interface). The second is the special 
computer programs which determine how the network elements 
will function (the SYSTEM SOFTWARE). 

There are a number of methods of linking microcomputers. In the 
case of the Acorn Econet, the computers are joined together on a 
common set of lines called a BUS. The data is transferred 
between computers at speeds which are greater than 100,000 bits 
per second. This is roughly 10,000 characters per second. The 
data is transmitted in blocks (called PACKETS) using a tech¬ 
nique developed by IBM called Synchronous Data Link Control or 
SDLC. The cable connecting the computers may be as much as 
one kilometer long. (Acorn Computers now recommend that the 
cable should not be longer than 500 meters.) It may have as many 
connection points on the cable as needed. For a more detailed 
description of the Econet interface, refer to Chapter 11. 



Figure 1.5 An Acorn Econet system 
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There are at least three tj^jes of system software needed for the 
Econet system described in this book. These are: 

• Network Filing System (NFS) 

• The File Server program 

• The Printer Server program 


Filing Systems 

All computers have some form of operating system to provide the 
links between your program and physical devices such as disks, 
video displays and printers. In the BBC Microcomputer, the 
operating system software has been divided between filing 
system and non-filing system tasks. A filing system is a program 
which links a user program to some off-line storage device such as 
a cassette recorder, disk drive or network file server. Non-filing 
system tasks such as driving the video display, keyboard, sound 
and speech synthesizers, light pen and real-time clock are 
performed by the Machine Operating System (MOS). Another 
important function of the MOS is to provide the link between the 
user program and the filing systems. This concept is developed 
further in Chapter 8. 

An important feature of the various filing systems is that their 
commands follow a common format. For example, to find which 
files are available, you would enter: 

*CAT 

This command will obtain a list of files from the Cassette, Disk, 
Cartridge ROM, File Server Disk or any other selected filing 
system. Every BBC Microcomputer has a Cassette Filing System 
(CFS) and a ROM Filing System (RFS). Machines fitted with a 
local disk drive would also have a Disk Filing System (DFS) 
installed. 

All computers on the network are fitted with the NFS. This 
program performs the task of handling data transmitted or 
received over the network. Most network commands relate to file 
server operations. The NFS simply acts as a mailbox, passing 
these commands to the file server for processing. 




Storage Cartridge 

ROM pack 


Figure 1.6 Structure of the BBC Microcomputer 















File and Printer Servers 


The most common resources shared on local networks are disk 
storage and printers. A computer with Econet interface and NFS 
is needed to link these devices to the network. In addition, the 
computer must be running a program which performs the server 
task. In this case, these are the file server and printer server 
programs. 

The printer server program is run as a time-sharing background 
task in a BBC Microcomputer station. This means that the 
printer server can still function as a user workstation (the 
foreground task). The background task is transparent; that is, the 
user is not aware of its presence. This is because printers are slow 
compared to the computer. Therefore, the processing speed of the 
station is hardly affected. 

The file server software is a large and complex program which 
must manage the files of all the users on the network. Unlike the 
printer server, a station operating as a file server cannot function 
as a user station at the same time. Three file server programs 
have been produced: 

Level 1 For a BBC Micro with disk drive only 

Level 2 For a BBC Micro with disk drive and 6502 
second processor 

Level 3 For an Acorn Eurocard System 3,4, or 5 

The Level 1 file server is written in Basic and is limited in its 
capabilities. This version is not discussed in this text. However, it 
is a subset of the full system and, as such, most of its features are 
covered. The main limitations of the Level 1 server relate to the 
maximum file size which can be loaded and saved. Also, this 
program does not support random access files. Its main purpose is 
to save and load small to medium-sized programs. 

At the time of writing, a Winchester (hard disk) file server is also 
under development. This is intended for use with a BBC Micro, 
Winchester disk drive and 6502 second processor. To the user at a 
station, the operation of the Level 2 and Winchester file servers is 
the same. 
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REVIEW 

In this chapter, we have examined the key elements of a local 
area network system, showing how networks have evolved to 
offer facilities similar to large time-share computer systems. This 
text is designed to assist the user to make best use of these 
facilities on the Acorn Econet. It is written as a station guide and, 
as such, views all network operations from the workstation. 



2 

GETTING STARTED 


A BBC Microcomputer workstation consists of the microcomputer 
(with Econet interface and NFS), a video monitor and a cable 
joining the workstation to the main cable. 

If you are sitting at a workstation, switch the computer and 
monitor on. You should see something like this on the screen: 

BBC Computer 32k 
Econet Station 235 
BASIC 
> 

or 

BBC Computer 32k 
Econet Station 235 No Clock 
BASIC 

> 

The first line indicates the amount of read/write memory (usually 
called Random Access Memory or RAM). The second line shows 
that the Network Filing System is selected. Each station has a 
unique number between 1 and 254 (in this case, 235). The station 
may select a variety of ROM-based programs when RESET such 
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as BBC Basic, Forth, a word processor or a terminal package. The 
third line shows that the Basic interpreter has been selected. If 
your computer does not display a message similar to one of the 
above, hold down the CONTROL and N keys. Press and release 
the BREAK key (CTRL-N-BREAK). Do not release the other 
keys until the display changes. Your screen may display: 

BBC Computer 32k 
BASIC 

> 

This means that your computer is not fitted with the Network 
Filing System. Therefore, it cannot function as a workstation. 
Another way to see if your computer has the NFS fitted is to enter 
the *HELP command. This will display a list of the programs 
stored in the ROM memory chips, inside the machine. For 
example, if you entered this command on the printer server, it 
would look something like this; 

>*HELP 

Printer Server 1.00 
NFS 3.40 
OS 1.20 
> 

Note; Throughout this book, all key entries are displayed, 
preceded by the Basic prompt >. This is an indication from the 
Basic interpreter that it is waiting for your input. Other 
programs display different prompts, for example, => for the 
View word processor, : for Forth and ? for Lisp. When entering 
commands, do not include the prompt character. Regardless of 
the prompt used, the commands have the same effect. However, 
there may be some difference in the format of the command. If 
unsure, check the system command format in the user guide of 
the software being used. 

If your computer is using a video monitor and you find that there 
is a slight screen flicker, you may remove this by typing *TV 0,1. 
Then change the screen mode to any number other than 7; e.g. 
type MODE 3. This command removes a characteristic of the 
screen display called INTERLACE. The picture may also be 
moved up or down. 
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Let’s begin by looking at the types of operations that may be 
performed at a workstation. First, we can communicate with a 
file server, moving data into and out of files on its disk drives. 
Second, we can send data to a printer server for printing. Finally, 
we can communicate with other workstations on the system. 
While the operation is different in each of these examples, they 
are performing essentially the same task, i.e. communicating 
with other computers across the network. File transfers between 
a workstation and the file server depend upon the ability of the 
Econet system to transfer data between stations. Again, access to 
the printer server relies upon the workstation’s ability to send 
data to the printer server for output to the printer. 


Communication between stations on the network is a complex 
task requiring an understanding of the filing and operating 
systems. If it were necessary to have a degree in computer science 
to be able to operate the network, it would be of little use to most 
of us. The designers have implemented the system at two levels. 
For normal use, there are high-level file and printer server 
commands in the NFS. If you wish to access the Econet at the 
system level, the manufacturer’s reference manual describes the 
low-level primitives which are used by the high-level commands. 
This guide discusses the use of the high-level commands only. 


LOGGING-ON THE FILE SERVER 

The file server allows users to quickly store and retrieve their 
program and data files. It includes a security system which 
prevents unauthorized access by other users. To use the file 
server, users must identify themselves to it. This process is called 
'logging-on’. Each user is allocated a user identifier (USERID). If 
users fail to identify themselves, they will be unable to access the 
file server. For example, the *CAT command displays a list of 
files. Without logging-on, enter this command. Remember to 
complete the command by pressing the RETURN key: 

>*CAT 

If the Econet and file server are operational and you have not 
logged-on, the normal response from the system is: 



18 

Who are you? 

> 

or 

Channel 

> 

This simply means that the file server does not recognize any 
user at your workstation. Therefore, you must identify yourself to 
the file server. To do this, you must have a USERID. If you 
receive any other error message, refer to Chapter 9. 

Let’s assume that our USERID is 'John’. To log-on we would t 3 rpe: 

>*I AM John 
> 

At this point, your system supervisor should have issued you with 
your own USERID. Log-on, using the ’*‘1 AM command. 

If you have executed this command correctly, the computer 
should return with the prompt >. Otherwise, an error message 
such as 'User not known’ would be displayed. Refer to Chapter 9 
for an explanation of any error message. 

The file server now knows who you are, and the station from 
which you are working. You should be able to display a catalog 
listing of files directly available to you by typing '*CAT’. A 
t 3 ^ical catalog would look like this: 

>*CAT 

John (127) Owner 

SYSTEM Option 0 (OfD 

Dir. John Lib. LIBRARY 

DRAWING WR/ LIST WR/ 

> 

The *CAT command is discussed in later chapters. The point of 
this exercise has been to show that access to the file server is only 
given to users who have logged-on with the '*I AM’ command. 



In the next chapter, you will learn how to find the USERID of 
other users by examining the disks on the file server. From this, 
you could expect to be able to log-on as any user. However the file 
server employs a security system which prevents you from doing 
this. Each user may set a PASSWORD which must be included at 
log-on, for example: 

>*I AM John AHnl76 
> 

where 'John’ is the USERID and 'AHnl76’ is the PASSWORD. If 
a PASSWORD is omitted or incorrectly typed, the error message 
'Wrong password’ will be returned. 

If the PASSWORD is displayed on the screen when logging-on, 
there is a chance that other users could see it. From version 3.40 
onward (as indicated by the *HELP command), the NFS allows 
you to log-on without displaying the PASSWORD. To do this, 
enter the command and USERID, followed by a space, a colon and 
a carriage return. The cursor will move to the next line, print a 
second colon and then wait for the PASSWORD to be entered. 
The PASSWORD will be accepted by the NFS, however it will not 
appear on the screen. Using the example above: 

>=^1 AM JOHN : 

:AHnl76 

> 

The text following the second colon and terminated by a carriage 
return is not displayed on the screen. It is included here to aid in 
the description. 

Using a PASSWORD, access to your files by other users is limited 
to whatever you choose to give. There is no PASSWORD allocated 
to a newly created USERID. The *PASS command (described in 
Chapter 4) allows you to set and change your PASSWORD after 
logging-on. 


LOGGING-OFF THE FILE SERVER 


Once you have logged-on to the system, you may load and save 
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your own programs and data files. If the system is to remain 
secure, you must also let the file server know when you have 
finished. We call this logging-off. If you don’t do this, the next 
user at your station could use your files. It is done by typing: 

>*BYE 

> 

After logging-off, try typing *CAT. The file server will respond 
with: 


Who are you? 

> 

This again indicates that the file server does not recognize you as 
a valid user. 


THE PRINTER SERVER 

Now that we have introduced communication with the file server, 
let’s turn oior attention to the printer server. Unlike the sharing 
of file storage, there is no security problem with printing, so users 
do not identify themselves to the printer server. All that is 
needed is to send a request to the printer server. Provided that it 
is not busy, the user will be given access. There are two steps in 
this process. 

The BBC Microcomputer has a number of ways of communicating 
with printers; for example, the Model B is fitted with Centronics- 
type parallel and RS-423 serial interfaces. Printers can be con¬ 
nected directly to the computer via these interfaces. The printer 
usually connects to the printer server station through one of 
these connections. Another option for printing is via the Econet 
communications system to a printer server. To select between 
these printer options, the user must enter an operating system 
command. These are: 

*FX5,1 Parallel 

*FX5,2 Serial 

*FX 5,4 Econet Printer Server 
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For example, if the printer connects to the RS-423 socket at the 
rear of the computer, it is selected by typing '*FX 5,2’. All BBC 
Microcomputers start with the parallel printer being selected. 
Therefore, to use the printer server we must select the Econet 
printer option after power-up and whenever CTRL-BREAK is 
pressed. Do this by t}T5ing; 

>*FX 5,4 
> 

The command may also be included in your programs. We must 
also send a command to instruct the computer to start printing. 

Until this is done, text to be displayed goes to the screen only. 
After sending this command, text is normally sent to both the 
screen and the printer. To do this, press the CTRL and B keys 
together. Within a Basic program, 'VDU 2’ or 'PRINT CHR$(2)’ 
has the same effect. A request is sent to the printer server for 
access. If the printer server is busy or not operating, the screen 
will display the error message; 

>CTRL-B 
Not listening 
> 

If any other error message is displayed, refer to Chapter 9 for an 
explanation. Enter the command and after receiving the prompt, 
type a few lines of text. To release the printer, t}q)e CTRL-C. 
Within a program, 'VDU 3’ or 'PRINT CHR$(3)’ has the same 
effect. 

The information sent to the screen should also have been sent to 
the printer. For a detailed description of the operation of the 
printer server, refer to Chapter 7. 


COMMUNICATING BETWEEN USER STATIONS 

So far we have looked at communication from a station to the file 
and printer servers. The Econet also supports communication 
between workstations. The main operations are: 
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^NOTIFY Send a message to another station. 

*REMOTE Take control of another station. 

*VIEW Display a copy of another station’s screen. 

The programs required to do these tasks are not part of the NFS. 
They are usually stored on a file server disk and loaded into 
memory when needed. Programs such as these extend the 
capabilities of the system software and are usually called system 
UTILITIES. They are sometimes called TRANSIENT COM¬ 
MANDS because they are executed in the same way as system 
commands (e.g. *VIEW 17, ’^'NOTIFY FRED) but are only 
resident in the computer while they are being used. A full 
description of these utilities is given in Chapter 6. Please note 
that these facilities may not be available on your system. If you 
are unsure, check with your system supervisor. These three 
utilities point to some of the ways that a computer network could 
be used as a communications system. Local, national and inter¬ 
national networks like Prestel and The Source provide facilities 
such as electronic mail. Econet has the capability to support a 
similar system within a local area. It is probable that this is 
where Econet will develop next. 


REVIEW 

In this chapter, we have examined the three t 5 q)es of communica¬ 
tion available on the Econet. We have seen that the file server 
will only communicate with workstations which have logged-on. 
This is done to provide protection for users from others who might 
illegally use their files. Since printing is open to all, it is not 
necessary to log-on to the printer server. However, it is necessary 
to select the printer server option at each workstation and to 
request access to the printer server. Finally, communication 
between workstations normally involves using utility programs 
such as NOTIFY, REMOTE and VIEW which are stored in the 
file server. Therefore, they are only available to users with access 
to the files in which they are stored. The following chapters show 
how to make full use of the facilities which have been introduced 
in this chapter. 
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SIMPLE FILE SERVER 
COMMANDS 


Most tasks performed on a computer involve accessing some form 
of off-line storage device. In the case of computers on the Econet, 
this is normally a file server. However, it may be a cassette or 
disk drive attached directly to the workstation. It is essential that 
you learn how to make effective use of the file server. In Chapter 
2, logging-on was introduced. This chapter describes the basic 
organization of files on the file server and introduces some of its 
commands. 


FILES 

To begin with, just what is a file? A file is a block (or group) of 
data items, stored in an organized way for future use, on 
magnetic tape or disk, paper tape, punched cards or some other 
storage medium. That’s quite a mouthful, but from it we can 
compile a list of key points; in a file: 

• The data is grouped in some way. 

• A storage medium is required. 

• The data is retrievable (i.e. it can be recalled). 


NBM-C 
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But What is Data? 


Data is a collection of alphabetic, numeric and other characters 
which represent some information. For example, we could create 
a file containing sets of numbers (data). By themselves, the 
numbers have no special meaning. They could represent 'con¬ 
sumption of bananas’, 'sales performance’, 'engineering computa¬ 
tions’, and so on. It is only by interpreting the data that the 
numbers become information. Sometimes with data, there is no 
human interpretation. It may be fed to another device which 
performs some task, based on the data sent to it. The numbers 
could now be used to change the position of a robot arm or to 
switch on a generator at a power station. 

One of the most common methods of entering new data into the 
computer is via a keyboard. Let’s assume that we have some data 
in the machine. To avoid rekeying the input data each time we 
want to use it and recalculating the result (output data), we need 
some more permanent storage. By using a device such as a 
magnetic disk, the data is not lost when the power is discon¬ 
nected. To store the data on the disk requires some organization. 
If the data were just 'thrown in anywhere’, its recovery would be a 
nightmare when next we wanted to use it. 

To avoid this, we must organize the data so that we know where 
to find it again. Data items which are related in some way are 
stored as a single item on the disk. We call this a file. It could 
contain data about banana consumption for the month of October. 
Another file could contain the program which calculates banana 
consumption. We usually treat files containing programs and 
those which contain data differently. Thus, there are two t 5 q)es of 
files: 


• Datafiles 

• Program files 

There are many good books covering the design and use of data 
files. Some titles are listed in the Bibliography. If you are 
unfamiliar with this subject you should refer to some of these. 
The file manipulation programs in Appendix A which create and 
display the contents of files will give some examples of how data 
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is stored and retrieved by BBC Basic programs. Most program 
files are an image copy of part of the computer’s memory. Saving 
and loading program files are usually simple tasks. Though the 
commands may vary slightly, there is little more involved than; 

SAVE filename and LOAD filename 

where 'filename’ is a unique name which is nominated by us to 
tell one file from another. 

An operating system command to save a file may be as simple as: 

>*SAVE FRED 1000 2000 
> 

or as complex as: 

>’*'SAVE FRED 1000 2000 OFOO OEOO 
> 

To save a simple Basic program called 'FRED’, the command is 
always the same: 

>SAVE "FRED” 

> 

To load the same Basic program file into memory, the command 
is: 


>LOAD "FRED” 

> 

With BBC Basic, the same program may be loaded and run in one 
operation by typing: 

>CHAIN "FRED” 

DISK ORGANIZATION 


The way files are arranged on the file server disk may seem 
daunting at first. It is really no more difficult than using a street 
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directory or the index to an encyclopedia. To introduce this, we 
will start by examining how files are managed on a computer 
with its own disk drive. We will then go on to look at the 
organization of a file server disk. In disk systems for standalone 
microcomputers, there is one part of the disk called the DIREC¬ 
TORY. It contains information which tells the disk filing system 
where to find all files on that disk. In this sense, a directory is 
similar to the index of a book. 



Figure 3.1 A single-level directory structure 

The types of data which the directory stores about each file 
include: 


• The filename 

• The position on the disk where the file begins 

• The length of the file 

• Where to load the file into the computer’s memory 

• The execution address (for program files) 

• The date when data was last written into the file 

In the directory, the information about each file is called a FILE 
ENTRY. A file entry is created whenever a new file is created. To 
delete a file from the disk simply involves deleting the file entry, 
for without the entry, the disk filing system is unable to find the 
file. The entry is updated automatically by the disk filing system 
whenever a change to the file changes any of the entry infor¬ 
mation; for example, if the filename is changed or if data is added 
to the file which changes its length. 

You will recall from the last chapter that you can obtain a list of 
files by t 5 ^ing '*CAT’. The purpose of this command is to display 
some of the information which is contained in the directory (a 
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catalog of the disk). In addition to selected information about 
each file entry, the *CAT command includes header information 
such as the disk name and the cycle number — the number of 
times that the directory has been written to. 

The user of a standalone computer has full access to all files 
stored on the disk. While this is fine for single users, it is not 
suitable for multi-user systems where we would like to keep each 
user’s files separated from all other users. We have described the 
directory as a part of the disk which contains information about 
how and where each file is stored. Now consider a directory which 
not only points to files but also to other directories on the same 
disk. The type of information which a directory would store about 
another directory includes: 

• The directory name 

• The position on the disk where the directory begins 

• The length of the directory 

• An indication that the entry refers to a directory 

• The date when the directory was created 

In the directory, the information about each subdirectory is called 
a DIRECTORY ENTRY. With this t 5 ^e of directory structure, 
many users can share the same disk storage. It allows each user’s 
files to be kept separate from other users. The purpose of the file 
server program (which runs in the file server station) is to 
organize and manage the directories. Figure 3.2 shows an exam¬ 
ple of this type of directory organization. 



Figure 3.2 A simple hierarchical directory structure 



It is called a TREE or HIERARCHICAL structure. Each directory 
has a unique name. The directory at the top of the tree is called 
the ROOT DIRECTORY. Its purpose is to provide a common 
starting point on all file server disks, regardless of how the rest of 
the disk is organized. It is possible (though undesirable) to have a 
disk with only a root directory. The name of the root directory is 
always $. 

A directory entry in the root directory is called a USER ROOT 
DIRECTORY (URD). BRIAN saves all of his files in his own part 
of the disk. When BRIAN enters the *CAT command, only his 
directory is displayed. Other than the root directory, the names of 
all file and directory entries may be up to ten characters long. In 
the example above, the URDs are LIBRARY, BOB and BRIAN. 
PASSWORDS is not a URD. It is a file entry in the root directory. 
This file holds the USERIDs and the PASSWORDS which are 
checked when a user logs-on. 

Just as directory entries can be created in the root directory, they 
can also be created in user root directories. Again, directory 
entries can be created in these directories. Directories below the 
URD are called subdirectories. This arrangement allows users to 
organize their files in groups which suit their own needs. Figure 
3.3 shows a directory organization which includes subdirectories. 
A user whose USERID matches a URD is described as the OWN¬ 
ER of that URD. The owner has unlimited access to all entries in 
and below his or her URD. 

In Figure 3.3, the URDs are LIBRARY, BOB, JIM, MARY, 
BRIAN and RALPH. Again, PASSWORDS is a file entry in the 
root directory. BOB owns the files !BOOT and STARTUP as well 
as the subdirectory WORDPROC. BOB also owns the three files 
chapl, chap2 and chap3 in WORDPROC. All URDs are created 
by the system manager. All entries in the URD and its sub¬ 
directories are created by the owner of the URD. 

In any given directory, entry names may be used only once. 
Therefore, each URD name and each filename must be unique. In 
the above example, note that there are two directories called 
WORDPROC. There is no problem with this as the directories 
are not entries in the same directory. Usually, the URD name 



matches the name of a USERID. Note that the name of each 
USERID must also be unique. 
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NEWPROG 


Figure 3.3 A typical disk organization 



Consider the case where a user with the USERID 'MARY’ and 
PASSWORD 'ABC127’ logs-on to a file server with a disk which 
has a directory structure as shown above. The user would type: 

>*I AM MARY: 

:ABC127 (Note: The password does not appear on the 

> screen.) 

The command is passed to the file server which checks the 
USERID, the PASSWORD and the auto-boot option (refer to 
Appendix A for a description of this featiire). If the USERID is 
correct, a check is made of the root directory to see if a URD exists 
with the same name as the USERID. In this example, there 
would be a match so the user MARY would be logged-on to the 
file server and three parameters would be returned to the 
workstation. These are: 

URD User Root Directory MARY 

CSD Currently Selected Directory MARY 

CSL Currently Selected Library LIBRARY 

This information is displayed in the 'header’ data at the top of a 
catalog listing. For example: 

>=*'CAT 

MARY (21) Owner 

SYSTEM_DISC Option 00 (Off) 

Dir. MARY Lib. LIBRARY 

BASIC DL/ GAMES DL/ 

WORDPROC DL/ ZULU WRJ 

> 

The header fields Dir. and Lib. refer to the CSD and CSL, re¬ 
spectively. 


USING OTHER DIRECTORIES 

Earlier in this chapter, it was suggested that a user can only see 
and access files within his or her own part of the directory tree. In 
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fact, this is a simplification. A user may examine and select any 
directory. However, it is up to the owner of that directory to 
decide what access (if any) other users may have. The CSD is the 
directory which is most often referred to in file server commands; 
for example, typing '*CAT’ refers to the CSD. However, other 
directories may be referred to in the command. If the user wishes 
to display the contents of the root directory, the command is; 

>*CAT $ 

$ (97) 

SYSTEM_DISC 
Dir. MARY 

BOB DL/ 

JIM DL/ 

MARY DL/ 

RALPH DL/ 

> 

In this case, the directory name of the root directory ($) was 
specified. 

If more than one name (directory and/or file name) must be 
included to describe the entry, each name is included, separated 
by a full stop. As an example of this, we may display a list of the 
contents of the user root directory LIBRARY by t 5 ^ing: 

>*CAT $.LIBRARY 

If the root directory name ($) was not included, the file server 
would search for a directory entry LIBRARY in the CSD MARY 
(i.e. MARY.LIBRARY). Whenever you refer to files or directories 
in other parts of the tree, you must specify the full directory 
name, starting from the root directory name $. 

To run the Basic program 'ZULU’ in the CSD MARY, she need 
only type: 

>CHAIN "ZULU” 


Public 


Option 00 (OfD 


Lib. LIBRARY 


BRIAN 

DL/ 

LIBRARY 

DL/ 

PASSWORDS 

L/ 


To run the program 'SPACEINVR’ in subdirectory GAMES, the 
command could be: 



>CHAIN "GAMES.SPACEINVR” 


In this case, the program would probably not run correctly as it 
calls the data file 'Spdata’. Most programs would be written 
expecting to find their data files in the same directory as the 
program. In this case, we must first change the CSD to the 
directory where the program and data files are stored. In order to 
do this, we would t 5 ^e: 

>*DIR GAMES 
>CHAIN "SPACEINVR” 


The *DIR command is used to change the CSD. The fact that the 
CSD has changed can be verified by typing '*CAT’ again: 


>*CAT 

GAMES (34) 
SYSTEM_DISC 
Dir. GAMES 


OWNER 
Option 00 (Off) 
Lib. LIBRARY 


SPACEINVR WR/ Spdata WR/ 
> 


The Dir. entry now shows GAMES. The program would now run 
correctly as both the program and data are in the CSD. 


OWNING THE DIRECTORY 

So far, we have accessed directories in our own part of the tree; 
that is, directories at or below our user root directory. Consider 
what would happen if we tried to access files belonging to other 
users. We can do this if the owner of that directory wishes to let 
us. The owner may grant PUBLIC access to individual files. This 
may be READ and/or WRITE access. Only read access should be 
given for programs. If a program needs to read and write to a data 
file, both access privileges (RW) must be given to the data file. In 
general, the rule is 'Never give a higher level of public access 
than is needed to use the file as it was intended’. No file may be 
deleted and no program may be overwritten by a non-owner. 

Having created a security system which protects a user’s files. 
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what is the point in now making them accessible to other users? 
While most of the files and text we create are for our own use, 
there are occasions when we wish to give access to others. For 
example, we may have a new computer game that we would like 
to share with our friends! Without public access, there would be 
no simple method of transferring files to other users. Another 
advantage is that files which are used by more than one user need 
only be saved once. This can mean a great saving in disk space. A 
good example of this is the library ($.LIBRARY). Programs are 
stored in the library for use by all users. This includes files such 
as 'FREE’ which allows you to find the names of the disks on the 
file server and 'VIEW’ which copies the screen of another station 
to your own. Clearly, these types of programs are of interest to 
most users. It would be a great waste of storage space to have 
individual copies of these files in each user’s directory. Therefore, 
they are stored with public read access. 

You will notice that catalog listings of your own directories 
display the word 'Owner’ in the top right-hand corner. If you own 
a directory, you have unlimited access to all file and directory 
entries within that directory. Only you can own your URD 
because your USERID (entered at log-on) matches the name of 
your URD. Therefore, if you keep your PASSWORD secret, no 
other user may log-on and become the owner of your files and 
directories. If there are directory entries in the us6r root 
directory, those directories are also owned. From this we can 
conclude: 

If we own a directory at any point on the tree, we own 

all files and directories below that point. 

Each file and directory entry has an associated string of 
characters which indicates the limits of access. Chapter 4 
describes the use of the access string. 

As described previously, you may change your CSD using the 
’•'DIR command; for example, '’*'DIR $’ and '*DIR $.LIBRARY’ 
select the root directory and the library, respectively. Remember 
that '*DIR LIBRARY’ would be incorrect as this would look for a 
directory entry LIBRARY in your own CSD, instead of in the root 
directory. When specifying a file or directory in any command, it 
takes one of two forms. If the entry is below the CSD on the tree. 
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the specification need only start from the level below the CSD. 
For example, if the URD and CSD are both MARY; 

*DIR BASIC.WORK = 

*DIR $.MARY.BASIC.WORK 

CHAIN "ZULU” = 

CHAIN "$.MARY.ZULU” 

*CAT BASIC = 

*CAT $.MARY.BASIC 

*LOAD "GAMES.Spdata” = 

*LOAD "$.MARY.GAMES.Spdata” 

CHAIN "BASIC.WORK.NEWPROG” = 

CHAIN "$.MARY.BASIC.WORK.NEWPROG” 


In all of these examples, the file and directory entries are owned 
by MARY. Now consider entries in other parts of the tree. If 
MARY wished to access file or directory entries in or below 
directory RALPH, the commands might be: 

*DIR $.RALPH 
CHAIN "SWOOP” 

or 

CHAIN "$.RALPH.SWOOP” 

In this case, the references are to entries in another part of the 
disk. The complete file or directory specification must be 
included. If the CSD is changed using the *DIR command, it is 
reset to the URD by t 5 rping: 

>*DIR 

In this example, the command resets the CSD to MARY. 

Note: If the directory specification is included when returning to 
the URD (e.g. *DIR $.MARY), the CSD is reset with non-owner 
access! Always use *DIR to reset the CSD to the URD. 
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CHANGING DISKS 

As well as changing directories, you may also select another disk 
on the same file server. This is done using the *SDISC command 
or by including the disk name in the directory specification of a 
*DIR command. Before doing this, you must know the names of 
the disks. This can be found using the *DISCS or *FREE utility 
programs which are normally stored in the LIBRARY. Both of 
these utilities list the disk names. For a complete description of 
these programs, refer to Chapter 10. To select directory FRED on 
the disk named MATHS, you would enter: 

>*DIR :MATHS.FRED 
> 

or 

>*SDISC MATHS 
>*DIR $.FRED 

> 

Note that the $ sign is not required where a disk name is included 
in the directory specification. If a new disk is selected (using the 
*SDISC command) which has a URD with the same name as the 
original disk, that directory will become the URD. Otherwise, the 
root directory will become the URD with public access. 

Consider where the URD and CSD are both :MATHS.$.FRED 
and a second disk on the same file server has a directory 
iSYSTEM_DISC.$.FRED. If user FRED entered the command: 

>*SDISC SYSTEM_DISC 
> 

his URD and CSD would become :SYSTEM_DISC.$.FRED. 

However, if SYSTEM_DISC did not contain directory $.FRED, 

the URD and CSD would become :SYSTEM_DISC.$ with public 
access. 

The main reason for using the *SDISC command is when a user 
wishes to select a new disk for the duration of the session. 
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Alternatively, if the *DIR command was used to change disks, 
you may return to the URD on the original disk by typing '*DIR’. 


CREATING NEW DIRECTORIES 

The user root directory is created for you by the system manager. 
Subdirectories are created (and deleted) by you. Subdirectories 
allow an owner to organize files into manageable units. Typical 
subdivisions could include: 

• Basic programs 

• Logo programs 

• Assembly language source programs 

• Assembled machine code programs 

• Word processor text files 

One thing to remember is that each directory takes up extra 
space on the disk. So don’t go overboard. If you have only a few 
files, there is no point in creating subdirectories for them. New 
directories are created, using the *CDIR command. The directory 
in which the entry is to be created must be owned by you. If user 
'JOHN’ wished to create subdirectory 'PASCAL’ in his user root 
directory (which would be his CSD), he would type: 

>*CDIR PASCAL 
> 

The directory entry PASCAL would then appear in catalog 
listings (using the *CAT command) with the access string DL/ 
(refer to Chapter 4). Now if JOHN wanted to create the directory 
entries SOURCE and OBJECT in directory PASCAL, he would 
type: 


>*DIR PASCAL (Make PASCAL the CSD) 

>*CDIR SOURCE 
>*CDIR OBJECT 


Finally, to return to the URD, JOHN would type *DIR. 
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EXEC FILES 

There are often times when the same information must be typed 
in repeatedly or you may have a few commands to enter which 
will take a long time to execute. The operating system includes a 
command (*EXEC) which allows text files to replace tiresome 
keyboard entry. To use this command, first create a text file using 
the *BUILD utility (described in Chapter 5) or a word processor. 
The file must contain exactly the same text that you would have 
typed at the keyboard. When you need to enter the text, simply 
type: 


>*EXEC filename 
> 

where filename is the name of the text file. The data is read from 
the file and stored in the keyboard input buffer. This is the part of 
the computer’s memory where all key strokes are stored until 
your program is ready to accept them. There are many uses for 
the *EXEC command. As an example, most programs sold on disk 
have an EXEC file called !BOOT which stores the sequence of 
steps required to load and run the program. This is useful since 
all we need to know to run any program is the auto-start 
operation, as described in Appendix A (usually at log-on or 
SHIFT-BREAK). Only !BOOT files in user root directories which 
have their auto-start option set to three are *EXECed at start-up. 
This is displayed as: 

Option 03 (Exec) 

in the *CAT and *EX header data. A !BOOT EXEC file may be 
examined using the *LIST and *TYPE commands. As a second 
example, an EXEC file was used to print the manuscript for this 
book, unattended. The text was created using Acomsoft’s VIEW 
word processor. To print a VIEW file, the command is: 

= >print filename 

where filename represents the name of the file to be printed. To 
print the document, 15 print commands were saved in another 
file called 'copy’. 
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The EXEC file looked like this: 

print chapl 
print chap2 
print chap3 
print chap4 
print chapS 
print chap6 
print chap? 
print chapS 
print chap9 
print chapA 
print chapB 
print apenda 
print apendb 
print apendc 
print index 

The manuscript was printed by entering the command: 


=>*EXEC copy 


As each print command was read from the keyboard buffer, it was 
executed. Thus, Chapter 1 was printed before accepting the next 
print command, and so on. It takes more than three hours to print 
the manuscript. After entering the *EXEC command, all that is 
needed is a cup of coffee and a good book (unless there’s some¬ 
thing decent on television!). 


REVIEW 

This chapter has introduced a number of important concepts. The 
central theme has been files and the file server. A file is simply 
related data grouped together on an off-line storage device — in 
this case, a file server disk. So that the file server can find the file 
when it is needed, information about the file is stored in a special 
part of the disk called a directory. The information about a 
particular file is called a file entry. If a filing system has only one 
directory, it is not suitable for more than one user. If users have 
their own directories, the system can prevent their files from 
being used by others. This is how the Econet file server is 
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arranged. To do this, information about a directory can be stored 
as an entry in another. In turn, this directory can be pointed to by 
another. Graphically, this is described as a tree or hierarchical 
structure, somewhat like a family tree. As well as providing file 
security, the directory structure allows users to organize their 
files in more manageable groups by the creation of subdirectories. 

With such a complex structure, commands are needed which 
allow movement from directory to directory and also from disk to 
disk. *CAT, *DIR, *DISCS, *FREE and *SDISC provide these 
functions. The *CAT command not only provides information 
about the file and directory entries in the specified directory, it 
also displays the disk name, the CSD, the CSL and the boot 
option for the URD. For the specified directory, the directory 
name, its cycle number (the number of times that the directory 
has been written to) and the user’s relationship (owner or public) 
are displayed. It is essential that all aspects of this command (and 
the information displayed) are understood. 

The log-on command (*I AM) is quite simple. However, users 
must understand the importance of system security. The pass¬ 
word must be kept secret and the user must always log-off when 
finished work. Another level of sophistication is added with the 
auto-boot facilities (described in Appendix A). This is particularly 
useful in situations where several stations perform the same 
sequence of tasks. Using a text processor, it is a simple matter to 
set up a boot file which is *EXECed when users log-on. 


NBM-D 
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RANDOM ACCESS 
FILES AND FILE 
SECURITY 


This chapter begins with a description of the BBC Basic com¬ 
mands which manipulate random access data files. The ability to 
access files using random access commands is affected by the 
setting of the file access string, associated with each file. The 
reader should have some knowledge of file handling, although it 
is not essential to understand the basics of user security which 
completes the chapter. 

The Econet system provides a high level of security for each 
user’s files. However, the success of any security system ultimate¬ 
ly depends on the way it is used. Users have control of their own 
file and directory access levels. Since passwords are an integral 
part of the security system, the chapter ends with a description of 
how to change your own password. 


RANDOM ACCESS DATA FILES 

If you have used other systems, the BBC Microcomputer’s file 
access method may seem a little strange at first. Its main 
attraction is its simplicity. There is really only one file type — 
sequential files. This is a system where file access begins at the 
first data block and a pointer is automatically incremented as 
each item is input or output. Random access is the ability to 
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directly select any item in the file. In the BBC Micro, random 
access is achieved by allowing the sequential file pointer to be 
repositioned by a user’s program. While this method takes a little 
getting used to, it offers the programmer a versatile and simple 
way of creating most data structures. The file access commands 
available in BBC Basic are: 


BGET# 

Get a byte from file 

BPUT# 

Put a byte to file 

EOF# 

End of file flag 

EXT# 

Length of file (extent) 

INPUT# 

Read integer, real and string variables 

OPENIN 

Open a file for update (Basic 1.0) 

Open a file for input only (Basic 2.0) 

OPENOUT 

Open a file for output 

OPENUP 

Open a file for update (Basic 2.0) 

PRINT# 

Write integer, real and string variables 

PTR# 

File pointer 


Before you use a data file, it must be found (or created) and 
temporary storage space must be reserved in the computer to hold 
incoming and/or outgoing data (the file buffer). There are three 
ways to open a file; read only (input), write only (output) and 
read/write (or update). Up to five files may be open at once. 
However, it is considered good practice to close any files which 
are not in use. Opening files is performed by the filing systems 
through an operating system call. Programming languages make 
this easier by performing most of the task. For example, to create 
a new file 'textltr’ in Basic, you could use the statement: 

>110 channel = OPENOUT ("textltr”) 

> 

When a file is opened, a channel number is allocated to the 
variable name nominated by the program. This is a number 
which is used by the operating system to refer to the selected file. 
Most of the file commands are followed by a # (hash) S3mibol. 
Immediately following the # should be the channel number of the 
referred file. 
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There are two commands for reading data from a file. These are 
BGET# and INPUT#. For example: 

30 A% = BGET# channel 
40 PRINT BGET# channel 
50 INPUT# channel, integer%, real, string$ 

BGET# reads one byte at a time while INPUT# can read a list 
which may be any combination of integer, real (floating point) 
and string fields. There are two commands for writing data to a 
file. These are BPUT# and PRINT#. For example: 

230 BPUT# channel, A% 

240 BPUT# newfile, BGET# channel 

250 PRINT# channel, integer%, real, string$ 

If a program attempts to read past the end of a file, an error is 
returned. To avoid this, programs should test for the end of file 
condition. The EOF# flag is used for this. For example: 

330 REPEAT 

340 PRINT BGET# channel; 

350 UNTIL EOF# channel 

Another way of doing this is to loop for the length (the extent) of 
the file. The EXT# variable records the number of bytes in the 
file. Using the last example: 

560 FOR loop_count = 1 TO EXT# channel 

570 PRINT BGET# channel; 

580 NEXT loop_count 

The file pointer (PTR#) may be read by a user’s program to find 
the current position of the pointer. It may also be written to. As 
described above, this permits random access file structures to be 
supported. To move to the start of a file, the command is: 

1630 PTR# channel = 0 

To move to the end of a file, the command is: 


650 PTR# channel = EXT# channel 
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If a program was required to read then update a record, the value 
of the pointer at the start of the record should be stored and then 
reset after reading. For example: 

340 start% = PTR# luno 

350 INPUT# luno, name$, address$, phone$ 


amend record 


420 PTR# luno = start% 

430 PRINT# luno, newname$, newaddress$, newphone$ 
The number of bytes required for the storage of data varies with 


the data type. 

Data Type Number of Bytes Type Flag 

Byte 1 nil 

Integer 5 &40 

Real 6 &FF 

String length of string plus 2 &00 


Integer, real and string fields are preceded by a byte which 
indicates the variable type. If the field contains a string, the type 
flag is followed by a byte which indicates the length of the string. 
Also, string data is stored in reverse! Here is how the number 10 
is stored for each of the variable types. 


Byte OA 

Integer 40 00 00 00 OA 

Real FF 00 00 00 20 84 

String 00 02 30 31 


To construct a random access file of fixed record length, you 
simply calculate the number of bytes in the record and then 
multiply this by the record number to find the pointer offset from 
the start of the file. For example, consider a fixed record length 
file which has two string fields and one integer field. The first 
string is 30 b 5 d;es and the second is 50 bytes long. String variables 
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are usually 'padded’ with spaces to make the string equal to its 
specified length, before writing it to the file. The number of bytes 
per record will be: 

(30 + 2) + (50 + 2) + 5 = 89 bytes 

The first record starts with the pointer equal to zero; the second 
at 89; the third at 178; and so on. That is, the pointer equals (89 * 
(the record number — 1)). 

In general, this is: 

The pointer for the nth record = record length * (n - 1) 
where the record length is the number of b 5 d;es per record. 


MULTIPLE ACCESS DATA FILES 


A problem arises for stations using the first release of BBC Basic. 
This version did not include a statement to open a file for read 
only. This does not mean that files cannot be opened in this way. 
Instead, the file must be opened by a call to the operating system. 
The following program shows how this can be done: 

10 osfind = &FFCE 

20 DIM name% 30 

30 

40 

50 

60 X% = name% MOD 256 : Y% = name% DIV 256 
70 channel% = FNopenread ("fred”) 

80 

90 

100 

110 DEF FNopenread (file$) 

120 $X% = file$ 

130 A% = &40 

140 A% = USR(OSFIND) 

150 A% = A% AND &FF 
160 = A% 
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Lines 10 and 20 should be included at the beginning of any 
program which must open files for read only. Line 20 reserves an 
area to hold the name of the file to be opened. X% and Y% pass 
the start address of the filename to the OSFIND routine via the X 
and Y registers in the CPU. If X% and Y% are used elsewhere in 
the program, they must be reset before each call to OSFIND. The 
function can be called from an 5 rwhere in the program. The format 
of the call is: 

channel number = FNopenread (filename) 

where the channel number is any integer variable and the 
filename is any string. Function openread should be included at 
the end of the program with other procedures and functions. On 
exit, the channel number is returned in A% as well as the integer 
variable which was assigned in the function call. In the above 
example, this was channel%. If the file could not be opened, the 
channel number returned is zero. If an error occurs, the error 
number and message are handled in the same way as if an 
OPENIN command had been used. 

Why do we need to open a file for read only when the read/write 
statement allows us to input data? The answer lies with the need 
to create files which can be read by more than one user at a time. 
The Econet file server supports a system of multiple read/single 
write access at the file level. This means that a file can be opened 
by any number of users for read only. However, to prevent the 
situation where a user is reading a file that someone else is busy 
changing (resulting in the wrong data being read), the file can 
only be opened for write access when no other user has opened it. 
Thus the need for a command to open for read only. 

When Basic 1.0 was written, this situation had not been allowed 
for. However, it was included in Basic 2.0. Does this mean that it 
is correct to design programs which use the Basic OPENIN 
statement if the network has Basic 2.0? The answer is that it 
depends on the purpose of the software. Is it likely that the 
program will be used where several users will want to access the 
program and the same data file at the same time? If so, and the 
software is to be transportable, or if your system has a mixture of 
stations with Basic 1.0 and 2.0, you should always use a call to 
the operating system as described above. This will guarantee that 
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your program will be compatible on all versions of the system. 
Clearly, this is essential. 

To find which version of Basic is fitted to your station, execute the 
following commands; 

=>*BASIC 

BASIC 

>REPORT 

(c)1981 Acorn 
> 

If the date displayed is '1981’, the version is Basic 1.0. If the 
message shows '1982’, it is Basic 2.0. This sequence can be 
executed from any language ROM (including Basic). 

You may be wondering how to avoid the problem of having 
several users writing as well as reading to a single file. One 
answer is to open the file for read only, find the record to be 
changed and then close the file. 

After amending the data, open the file for read/write and write 
the updated record to the file. You may need to check that no one 
else has changed your record while you were amending the data. 
Finally, close the file again. Remember that you must check that 
your file pointers are correct before writing the new data. By 
using this method, the file is available most of the time. When 
opening the file, you must 'trap’ (test for) any 'File already open’ 
errors and loop until the file is available. This should only be a 
maximum of a few seconds. In any case, it is a good idea to display 
a message such as 'Please wait’ so that it is clear to the user what 
is happening. 


FILE SECURITY 

All directories have two levels of access: owner and non-owner 
(public). Ownership of a directory implies ownership of all files 
and subdirectories within that directory. Using the ^ACCESS 
command, the owner of a directory may change the level of access 



of individual files for themselves as well as other users. The 
command is also used as part of the process of deleting a sub¬ 
directory. 
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FILE ACCESS 


Associated with every file and directory entry is a field known as 
the ACCESS STRING. For files, this may be up to six characters 
long. The maximum is LWR/WR. The / separates the owner 
access field on the left from the public access field on the right. To 
understand the full significance of this string, we need to know 
what ownership and non-ownership means to a user. 


OWNER 

May create files and 
directories. 

May delete files and 
directories. 

May change access 
strings. 

May save a program into 
a new or existing file. 
May read any file if he 
has given himself read 
access. 

May write to any file if he 
has given himself write 
access. 


NON-OWNER 
May not create files or 
directories. 

May not delete files or 
directories. 

May not change access 
strings. 

May not save a program 
into a new or existing file. 
May read any file if the 
owner has given him read 
access. 

May write to any file if 
the owner has given him 
write access. 


The purpose of the *ACCESS command is to change the access 
string to suit the needs of owners and non-owners. All files are 
created with the access string WR/. This means that the owner 
may read program and data files. If it is a data file, the owner 
may write to the file using random access file commands. For 
example, in Basic, this allows the PRINT# and BPUT# state¬ 
ments to be used. It is not intended that a program file be opened 
as a data file. Therefore, it is wise to remove the write option from 
the access string after creating a program file. A third parameter 
may be added to the field. This is the lock character L. If this 
appears in the string, it means tljat the owner cannot delete the 
file or save a complete file of the same name. It is intended as a 
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safeguard for the owner to protect valuable files from accidental 
erasure. Once a program is developed, it is a good idea to set the 
owner access level of the program file to LR/. 

So far, we have looked at the owner access field. The level of 
public access is defined by the field following the / in the access 
string. An obvious difference between owner and non-owner 
access relates to the initial creation of a file. The owner of a 
directory is given unlimited access to create files while non- 
owners have none. There is no public access unless the owner 
gives it. Also, the owner may wish to limit his own access level. 
There is no lock parameter after the /. All files and directories are 
locked from non-owners. This cannot be changed. Non-owners 
cannot create or delete files or directories and they cannot change 
access strings. Therefore, all they can do is load programs and 
open data files for read and write operations if given access by the 
owner. Since the system cannot tell the difference between 
program and data files, take care not to give public write access to 
files which contain programs. 

Program files which are given both public and private access 
usually have their access string set to LR/R. If you have a data 
file which must be opened for read only by a public access 
program, it would also be set to LR/R. Finally, if a program has 
public access and uses a data file which must be opened for 
update, it would be set to WR/WR. In this case, it is a good idea to 
make a backup of the file in case it is corrupted by a public access 
user. Note that this is the maximum access that can be given to a 
file. The lowest access level is L/. That is, the file cannot be 
deleted, read from, or -written to, by either the o-wner or non- 
owner. One use of this is to protect copies of important files. 

Characters may be entered in any order in each field of the access 
string. For example: 

^ACCESS FRED LWR/WR = 

*ACCESS FRED RLW/RW 

The only requirements for the string are that the filename is 
separated from the access string by at least one space. However, 
there must be no spaces (or other illegal characters) between the 
first character of the access string and the carriage return which 



49 


completes the line. Thus, 

*ACCESS FRED LWR/ WR 
is not valid. 

To delete a file, it must be unlocked. The simplest way to do this 
is: 


>*ACCESS FRED 
>*DELETE FRED 
> 

DIRECTORY ACCESS 

The directory and file access strings are quite different. Read and 
write access have no meaning for directories as they do for files. 
There is no concept of reading from and writing to directories. 
However, anything that can be created should also be able to be 
deleted. Therefore, there is a need to be able to lock the directory 
for protection. Also, it is important that the user can tell the 
difference between files and directories. Both of these features 
are incorporated in the directory access string. 

All directories are created with the access string DL/. The first 
character indicates a directory entry. As with the file access 
string, the directory string is alvvays locked from the public. Only 
two operations can be performed on the directory string. It can be 
locked and unlocked. Normally, a directory would only be un¬ 
locked to be deleted. For example, to delete directory MARY, the 
commands would be: 

>*ACCESS MARY 
>*DELETE MARY 
> 

Note that you must own the directory in which the entry MARY 
resides. In addition, directory MARY must be empty before it can 
be deleted. That is, it must contain no file or directory entries. 
This can be checked with the *CAT command. Finally, it must 
not be yours or any other user’s URD, CSD or CSL. To attempt to 
do so would return the 'Already open’ error message. Should you 
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find that you have unlocked the wrong directory it can be 
relocked with the *ACCESS command. Using the previous 
example; 

>*ACCESS MARY L 
> 

Note that the letter D, which appears in listings of the catalog, is 
not included in the command. 


WILDCARDS 

Should you wish to lock a group of file or directory entries, you 
may do this with a single command using a wildcard. The * 
character means 'any string of characters’ and # means 'any 
single character’. Some examples of this are: 

*ACCESS * LR/R Lock all files in the CSD and give 

read access. 

*ACCESS JACK.f*' Unlock all entries in JACK which 

start with 'f’. 

^ACCESS B#ll L Lock Ball, Bell, Bill, Bull, etc. 

Wildcards can be used with other commands, however its effect is 
different. With these, the command is directed to the entry whose 
name comes first alphabetically. Using the above example, *DIR 
B#ll would select subdirectory Ball. Note that wildcards are not 
available in earlier versions of the file server software. If unsure, 
check with your system supervisor. 


CHANGING PASSWORDS 

When a new USERID is created, there is no password string 
associated with it. We call this a zero length (or null) string. 
Often strings are defined by placing them in quotation marks 
(e.g. "FRED”). Therefore, a null string could be described as "”. 
Owners may change their password at any time after logging-on, 
using the ’•'PASS command. The format of this command is; 
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*PASS "old password” "new password” 

If a new user FRED wished to create his own password (let’s say 
'YNOOM’), he would enter the commands; 

>*I AM FRED 
>*PASS "” "YNOOM” 

>*BYE 

>*I AM FRED : 

:YNOOM (YNOOM would not appear on the screen.) 

In this example, FRED logged-on, changed his password, logged- 
off and finally logged-on again to verify that the password had 
been set correctly. This last stage should be done immediately to 
avoid mishaps. 

Note that quotation marks are only required for null strings. 
Other strings only need to be separated by spaces. For example: 

*PASS X4127 XY6463 

To set a password back to a null string, the command would be: 
*PASS "old password” "” 

Finally, here are a few commonsense ideas to guarantee trouble- 
free use of the network: 

• Never tell ANY ONE your password. 

• Never change your password if anyone else can see your 
screen. 

• Always use the blind log-on form of the *I AM command 
if it is available. 

• Choose your password carefully. It should not be obvious 
to others but should be easy for you to remember. 

• Never write your password down. If you should forget it, 
contact the system supervisor. 
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REVIEW 

Since the Econet is a multi-user system, shared data bases are a 
part of the system. This chapter has explained the basics of 
programming with data files and has extended the discussion to 
describe a method of opening files for read only, using the 
operating system OSFIND call. It is essential for programs to 
work on all networks. Therefore they must use this method for 
opening data files when the files are to be accessed by more than 
one user at a time. 

This chapter has introduced the technique by which you may 
change the protection level of your files. This allows you to give 
other users limited access. It also allows you to protect your own 
files from yourself. Never underestimate the value of this second 
point. Backup copies of valuable files should always be made. As 
well as this, it is wise to provide the maximum level of protection 
to files which will still allow your programs to function correctly. 
As an example, working programs should have their access string 
set to LR/ (or LR/R if you wish to grant public access). If a data file 
is only for input, open the file for read only in your programs and 
set the string for read only. 

The need for security can not be overemphasized. There are 
countless stories of users giving their password away to their 
'friends’, only to find their files corrupted or missing. If you want 
others to have access to some of your files, use the security system 
as it was intended by setting the access string on those files only. 
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WORKING WITH 
FILES 


In earlier chapters, the file server was introduced as a storage 
device for program and data files. While this is correct, it is 
somewhat simplistic. An indication of its greater potential was 
given in Chapter 3 with the introduction of the *EXEC command 
which allows keyboard entries to be replaced with text from a file. 
Chapter 3 also explained the construction and use of files and 
Chapter 4 introduced random access data files. A thorough un¬ 
derstanding of the contents of those chapters is essential before 
going further. 

This chapter will develop a number of ideas which will allow you 
to use the file server at its full potential. A good deal of the 
material is quite advanced. You may prefer to skip the section 
'Examining Files’ on your first reading. Frequently, references 
will be made to the hexadecimal number system in this chapter. 
If you are not familiar with this notation, you should study the 
contents of Appendix B. Hexadecimal numbering is used fre¬ 
quently with the operating and filing systems of the BBC 
Microcomputer. It is essential that you are familiar with it. 


TEXT FILES 

All printing characters (and also non-printing ones, i.e. control 
characters) are stored as single byte numbers; for example, the 
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capital letter A is stored as one byte containing the number 65. 
(This is &41 in hexadecimal or 01000001 in the binary number 
system.) This method of storing characters is called ASCII coding 
(American Standard Code for Information Interchange). ASCII 
characters below the value of 32 (&20) are called Control Codes. 
Some of these have the same meaning on most computers (e.g. 
CTRL-M represents a carriage return) while others are given 
special meanings on some systems. In the BBC Microcomputer, 
they are called VDU codes. In the Teletext mode (Mode 7), there 
are more characters (represented by numbers above 127) which 
affect the format of the display. Complete lists of the VDU, 
Teletext and ASCII codes are given in the BBC Microcomputer 
User Guide. 

Since any b 3 rte which contains a number from 0 to 31 or from 128 
to 255 can be interpreted as a control character, there may be 
problems when displaying a file which does not just contain text. 

For example, consider a Basic program file which contained a line 
number of two. The printer would be switched on if the program 
was listed directly on the screen (using the *TYPE command 
which is described in this chapter). A text file only contains data 
which can be displayed on the screen and/or printer. This usually 
includes the ASCII codes with values from 32 to 126, 13 (a 
carriage return) and sometimes 10 (a line feed). 


CREATING TEXT FILES 

The text is normally created and edited using a word processor 
such as WORDWISE from Computer Concepts or Acornsoft’s 
VIEW (although this does not produce true text files as the text 
may contain bytes which are greater than 126). If a station has a 
BUILD utility available (as in the DFS), this can also be used to 
create text files. For example, to BUILD a text file called !BOOT 
(pronounced 'pling boot’), enter the command; 

>*BUILD !BOOT 

0001 The file !BOOT is created. 

0002 Up to 255 characters may be entered on each line, 
0003 terminated by a carriage return. 

0004 To correct a mistake, erase all characters 
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0005 back to the error with the DELETE key. 

0006 To end the text entry, press the ESCAPE key. 

0007 [Press ESCAPE] 

> 

There is another way to create text files. Using the *SPOOL 
command of the machine operating system, all text sent to the 
screen can also be saved in a file. The following program shows 
how this could be used to create text files: 

10 *SPOOL [BOOT 
20 PRINT "*TV 0,1” 

30 PRINT "MODE 7” 

40 PRINT "CHAIN ""INVADERS””” 

50 *SPOOL 

The text to he saved in the file is displayed on the screen and is 
also sent to the nominated spool file. Note that pairs of quotes are 
used in line 40 to include a quote within a quoted string. RUN 
this program and then display the contents of the file IBOOT, 
using a word processor or the *LIST or *TYPE commands (or one 
of the equivalent Basic programs described in Appendix C). 


DISPLAYING TEXT FILES 

There are many times that you will want to read the contents of 
files. If they are text files, there are two DFS utilities for this 
purpose: *LIST and *TYPE. If you have a word processor, it can 
also be used for this. If your station has no word processor or a 
*TYPE or *LIST utility, equivalent Basic programs are described 
in Appendix C. 

The *LIST utility displays the contents of text files in the same 
format as when they are created by *BUILD. That is, with line 
numbers at the start of each line. Using the previous example: 

>*LIST IBOOT 

0001 *TV 0,1 

0002 MODE 7 

0003 CHAIN "INVADERS” 

> 


NBM-E 
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The *TYPE utility displays the contents of text files without line 
numbers. This is how the text is actually saved in the file, that is, 
without line numbers. Using the same example: 

>*TYPE !BOOT 
*TV 0,1 
MODE 7 

CHAIN "INVADERS” 

> 


LOADING AND SAVING FILES 

Some files are saved from and loaded into memory in one 
operation while others are processed in smaller units (random 
access files). Where a file is to be transferred between off-line 
storage and memory in one operation, you may wish to use the 
operating system *LOAD and *SAVE commands. 

To load a file into memory, the command is: 

*LOAD filename 

where 'filename’ is the name of the file to be loaded. The filename 
may be in quotation marks if desired. If the program is to load at 
a new address, this is specified in the load command as a 
hexadecimal number. 

*LOAD "filename” load address 

Care must be taken when *LOADing files that they do not 
overwrite the operating system workspace. For example, files 
created under the cassette filing system often load at &E00. If 
these files are loaded at the same address on a network or disk 
machine, it will probably destroy the system workspace. In this 
case, a load address must be included in the command to load the 
file at a higher memory address. The upper limit where a file can 
be loaded is determined by its length. This is usually set by the 
video display memory start address. This will vary with the 
screen mode selected. For any mode, the start of screen address 
should be greater than the sum of the load address and the length 
of the file. 
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Programs such as word processors and programming languages 
(e.g. Basic) usually have their own save and load commands. 
However there are times when the *LOAD and *SAVE com¬ 
mands are more useful; for example, to save a Basic program plus 
assembled machine code as one file. The *SAVE command stores 
an image copy of a specified section of memory in a file. 


In its simplest form, the command is: 


*SAVE filename 
or 


start end 
address address 


*SAVE filename start 4- length 
address of file 


The *SAVE command must specify a filename, a start address 
and an end address or length of file. Files may also have an 
execution address. This is the memory address where the filing 
system transfers control to, after loading the program. If no 
execution address is included when the file is saved, the start 
address is assumed. If a file is loaded at an address which is 
different from where it was created, the old load parameters can 
be reset when the file is saved again. The complete format of the 
*SAVE command is: 


*SAVE 

filename 

start 

end 

execution 

load 



address 

address 

address 

address 

or 






*SAVE 

filename 

start 

-I- length 

execution 

load 



address 

of file 

address 

address 


When transferring a file from tape to disk, the start address is 
where the file is *LOADed into memory. This will be either the 
default load address (which is stored on the tape) or one specified 
in the *LOAD command. The file length and execution address 
are the values displayed when the file loads from cassette into 
memory. If you load the file at a new address, you may reset the 
original load address when saving the file. This is the last 
parameter in the *SAVE command. If it is included, an execution 
address must also be specified. 
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RENAMING FILES 

Filenames are specified when a file is created. However, there are 
times when the owner of a file may wish to change its name. The 
file may also be moved to a new directory. This is done using the 
^RENAME command. 

For example: 

>*RENAME FRED JIM 
> 

will change the name of the file from FRED to JIM in the 
Currently Selected Directory. 

>*RENAME FRED PASCAL.FRED 
> 

will move the file FRED from the Currently Selected Directory to 
the subdirectory PASCAL. 

>*RENAME BASIC.JOE GAMES.SWOOP 
> 

will move the file JOE from subdirectory BASIC to subdirectory 
GAMES. Also, the filename will change to SWOOP. 

Note: The *RENAME command cannot be used across disk 
boundaries since this involves moving the complete file. Also, the 
*RENAME command cannot change the file entry of a locked file. 
Finally, the user entering the command must be the owner of 
both the old and new directories. 


EXAMINING FILES 

Examining the contents of files (particularly those which are not 
owned by you) can be as complex as a good adventure game. 'You 
are in alien territory, surrounded by strange files! Your mission 
... to find what lurks within.’ 
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File Entry Parameters 

This section shows you how to find out what files contain. The 
amount that you can discover will depend on your level of file 
access. If you cannot read the file, you are limited in what you can 
learn. However, we shall begin there. Some files (such as Basic 
and machine code programs) are designed to be read into memory 
in one operation. The filing system must know where to load the 
file into memory (the LOAD ADDRESS) and the length of the file 
(the EXTENT). Files may also have an execution address (the 
ENTRY POINT). This is the memory address to which the filing 
system transfers control, after loading the program. Normally, 
the execution address is within the area of memory where the 
program is loaded. In some cases (such as Basic programs), it is 
independent of the file loaded. This can be an indication of the file 
type. For example, Basic 1.0 programs have the execution 
address &801F while Basic 2.0 transfers control to &8023. With 
practice, you will learn to recognize other types of files by their 
execution address. 


Using the *IIMFO Command 

To read a file’s load parameters, there are two commands: *INFO 
and *EX. The *INFO command returns the parameters for 
individual file and directory entries. For example: 

>*INFO FRED 

FRED FFFF1900 FFFF801F 0003BE 

WR/ 16:10:83 0021A 

> 

The owner of the file FRED has read and write access while non- 
owners have no access to the file (WR/). 

In a BBC Micro with second processor, there are two blocks of 
memory (one for each CPU). There must be some way of telling 
the operating system which block of memory to load files into. If 
the load and execution addresses begin with FFFF, the file would 
be loaded into, and control transferred to, the BBC machine 
rather than the second processor (if one is attached). Addresses 



starting with 0000 refer to the second processor (if there is one 
connected and operating). Otherwise, these files are also loaded 
into the BBC Micro. 

Judging by the entry point (&FFFF801F) of the file FRED, it 
probably contains a Basic program. The load address is 
&FFFF1900. This suggests that the program was originally 
saved on a BBC Microcomputer with disk drive. The effect of 
different filing systems on the Basic load address (PAGE) is 
described later in this chapter. In the case of a station with second 
processor running Basic, program FRED would load into the 
second processor (even though the load address starts with FFFF) 
because the Basic interpreter always specifies a load address 
(PAGE). 

The next field (0003BE) displays the length of the file. In this 
case it is almost 1000 b 3 d.es long. The file was last saved on 16 
October 1983. The disk on which the file is stored is divided into 
256-byte blocks (called SECTORS). The first sector on the disk 
that the file FRED occupies is number 538 (&21A). This is called 
the System Internal Name (SIN) of the file. In this example, the 
last two fields are of only minor interest. They are included here 
for completeness. 

Using the *EX Command 

The *EX command is a combination of the *CAT and *INFO 
commands. The directory header data is displayed, followed by 
the entry data for all file and directory entries in the specified 
directory. For example: 

>*EX iSystem_disc.$.John 

John (127) Owner 

System disc Option 00 (Ofi) 

Dir. Mary Lib. LIBRARY 

DRAWING FFFF1900 FFFF801F 000186 
WR/ 17:07:83 00125 

LIST FFFF1200 FFFF801F 000065 

WRy 16:10:83 00098 

> 
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*EX in Other Fifing Systems 

In the cassette filing system, there is no direct equivalent to the 
*INFO and *EX commands. To find detailed information about 
cassette files enter the command *OPT 1,2 and then execute the 
*CAT command. This will return the load and the execution 
addresses and the file length, as each file is read. In the disk 
filing system, *EX is replaced by the *INFO *.* command. 


Going Inside the File 

If you have read access to files, you can find more about the 
contents of files than the *INFO command will reveal. A good 
place to start is with the *DUMP utility. If your station does not 
have this command available, see Appendix C. 

The *DUMP utility displays the contents of files, b 3 d;e-by-byte in 
hexadecimal notation. Also, if the byte contains a number which 
is equivalent to a printable ASCII character (numbers greater 
than 31 and less than 127), the character is displayed in the third 
column. Numbers less than 32 and greater than 126 cannot be 
displayed on the screen. They are represented by a full stop. If 
you find (using *DUMP) that a file contains only text plus 
carriage returns (&0D) and possibly line feeds (&0A), you may 
use *TYPE and *LIST to display the file. The following example 
displays the contents of a Basic program file, created earlier in 
this chapter. 

>*DUMP SPOOLBILD 


0000 

OD 00 

OA 

10 

2A 

53 

50 

4F 

....*SPO 

0008 

4F 

4C 

20 

21 

42 

4F 

4F 

54 

OL [BOOT 

0010 

OD 00 

14 

OF 

FI 

20 

22 

2A 


0018 

54 

56 

20 

30 

2C 

31 

22 

OD 

TV 0,1”. 

0020 

00 

IE 

OE 

FI 

20 

22 

4D 

4F 

.... "MO 

0028 

44 

45 

20 

37 

22 

OD 

00 

28 

D E 7 ” .. ( 

0030 

lA FI 

20 

22 

43 

48 

41 

49 

.. " C H AI 

0038 

4E 

20 

22 

22 

49 

4E 

56 

41 

N ""INVA 

0040 

44 

45 

52 

53 

22 

22 

22 

OD 

D E R S ” ” ” . 

0048 

00 

32 

OA 2A 53 

50 

4F 

4F 

.2.*SPOO 

0050 

4C 

OD FF 






L. 


> 
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Observe that the first column displays the position of the first 
byte in each line, offset from the start of the file, as a hexadecimal 
number. The first line begins with four bytes which contain 
numbers less than 32. They are displayed in the ASCII column as 
full stops. All Basic programs begin with &0D (a carriage return). 
This is followed by the line number which takes two b 5 d;es 
(&000A = 10). The fourth byte indicates how many b 3 d;es are in 
the line. This includes all bytes from the line number to the 
carriage return at the end of the line. In this case, there are 16 
(&10) bytes: 


00 OA 

10 

2A 

53 

50 

4F 

4F 

4C 

20 

21 

42 

4F 

4F 

54 

OD 

line 

line 

* 

S 

P 

0 

0 

L 


[ 

B 

0 

0 

T 

carriage 

10 

count 













return 


This first line does not contain any Basic keywords. Other than 
the line number and line count, the line can be read from the 
third column. Compare this to the next line which begins with 
byte number &11. The line reads: 


00 14 

OF 

FI 

20 

22 

2A 

54 

56 

20 

30 

2C 

31 

22 

OD 

line 

line 

? 


tt 

* 

T 

V 


0 

, 

1 

” 

carriage 

20 

count 












return 


We know that the third byte contains the number of bytes in the 
line (15). What is the fourth b 3 rte? To answer this, we must 
understand how Basic commands are stored. Keywords such as 
PRINT, IF, REPEAT, REM, etc. are stored in single bytes as 
unique numbers called COMPRESSION CODES or TOKENS. 
The Basic PRINT command is represented by the number &F1 
(as in the program line above). For a complete list of BBC Basic 
tokens, refer to the BBC Microcomputer User Guide. 

To indicate the end of a program, the carriage return on the last 
line is followed by a byte containing the number «&;FF. Basic 
programs never have line numbers greater than &7FFF. Since 
line numbers starting with &FF (&7F is the largest) can never 
exist, this is always the end of the program. If there are any 
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unused bjd;es in the last line of a *DUMPed file, they are dis¬ 
played as double asterisks. 

Another t 3 ^e of program file which may be easily identified is one 
containing machine code. Such files usually contain data which is 
mainly unprintable codes. Frequent use of numbers such as &A9, 
&AD and &4C (machine code for load accumulator immediate, 
load accumulator absolute and jump absolute, respectively) are a 
good indication of machine language programs. Machine code 
may be mixed with other programming languages. For example, 
it is common practice to mix Basic and machine code programs 
together. If a program has been produced for another filing 
system which mixes Basic and machine code (e.g. the cassette 
filing system), you must ensure that the program operates at the 
location in memory that it was written for. Cassette programs 
usually load at &E00, though some go even lower to discourage 
file copying. These files must be loaded at a higher address in 
memory and then shifted down to the correct location before 
execution. 


TRANSFERRING A CASSETTE FILE 

Consider a program file called RALPH which contains Basic and 
machine code. The program was purchased on cassette but we 
would now like to transfer it to the file server. The program does 
not read or write to data files so it does not matter if we write over 
the system workspace from &E00 to &1200 after the file loads 
from the file server. Some network transactions could still 
corrupt the program so it may be necessary to unplug the Econet 
cable after loading the program. A hard reset (CTRL-BREAK) 
should be executed after the program ends. Also the user would 
need to log-on again as Econet parameters such as file and 
printer server numbers will be corrupted. 

The steps required to transfer this file are as follows: 

1. Log-on to the file server: 

>*I AM BRIAN : 


> 



2. Check where the operating system high water mark is 
located, that is, the start of user memory (which is 
usually equal to PAGE in Basic). 

>PRINT ~ PAGE 
IBOO 
> 

The value of PAGE suggests that this machine probably 
contains disk and network filing systems. 

3. Select the CFS and set the load option which displays a 
file’s load parameters. 

>*TAPE 
>*OPT 1,2 
> 

4. Make sure that there is the maximum free space 
available by selecting Mode 7 (if no second processor is 
attached). 

>MODE 7 
> 

5. Load the file into a safe part of memory (in this case, 
&1B00 or higher). 

>*LOAD RALPH 2000 
Loading 

RALPH 14 14C3 FFFFOEOO FFFF801F 
> 

6. Transfer the file to the file server using the original 
load address so that you will know where the program 
should load in the future. 


>*NET 

>*SAVE RALPH FFFF2000 + 14C3 FFFF801F 
FFFFOEOO 
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7. Create and save a Basic program which will load the 
main file into memory and then relocate it at the correct 
address. This program will load into high memory, clear 
of the main program. Line 20 selects the Cassette Filing 
System to prevent unwanted network operations. Lines 
30 to 50 move the main program down, four bytes at a 
time. It then resets PAGE to point to the relocated 
program. Finally, it transfers control by inserting OLD 
(which resets the Basic pointers) and RUN into the 
keyboard buffer. 

>AUTO 

10 *LOAD RALPH 2000 
20 *TAPE 

30 FOR 1 % = 0 TO &14C3 STEP 4 
40 I%!&E00 = I%!&2000 
50 NEXT 1% 

60 PAGE = &E00 

70 REM put"OLD|M RUN|M” into keyboard buffer. 
80 *FX138,0,79 
90 *FX138,0,76 
100 *FX138,0,68 
110 *FX138,0,13 
120 *FX138,0,82 
130 *FX138,0,85 
140 *FX138,0,78 
150 *FX138,0,13 
160 END 

170 [Press ESCAPE] 

Escape 

>SAVE "RLOAD” 

8. Create a !BOOT file to load RALPH automatically. The 
file should ensure that Basic is selected, that MODE 7 is 
selected if there is no second processor attached, and 
that PAGE is set to load the loader program (RLOAD) 
above the space where the main file (RALPH) will load. 

>*BUILD IBOOT 
0001 *BASIC 
0002 MODE 7 
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0003 PAGE=&7000 
0004 CHAIN "RLOAD” 

0005 [Press ESCAPE] 

Escape 

> 

9. Also, the auto-boot option should be set (refer to 
Appendix A). 

>*OPT 4,3 
> 

10. Test the program by logging-on or by entering the 
command. 

>*EXEC IBOOT 

The program should operate as follows; 

1. When logging-on to the file server, the 'IBOOT’ file will 
*EXEC automatically. It will ensure that Basic is 
active. Next, it selects the teletext screen and then sets 
the Basic program load address (PAGE) to &7000. 
Finally, the program loader ('RLOAD’) loads and exe¬ 
cutes at that address. 

2. The loader program loads 'RALPH’ into memory at the 
address &2000. It then shifts the file down to the correct 
operating address, four bytes at a time. If 'RALPH’ 
loaded directly at &E00, the NFS and/or DFS work¬ 
space would be corrupted. It is most unlikely that the 
file would load successfully. The *TAPE command is 
included in 'RLOAD’ to ensure that the program does 
not attempt to access the network while the system 
memory is corrupted. 

After moving 'RALPH’ down to &E00, PAGE is set to 
point to the start of the program. Finally, 'RALPH’ is 
executed by inserting the commands OLD and RUN 
into the keyboard buffer. 

This exercise has introduced a number of important concepts. 

There is a point in memory called the Operating System High 
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Water Mark (OSHWM). This is the address of the first memory 
location above the system workspace which is available to the 
user. User memory extends from this point to the start of the 
video memory area. The Basic interpreter starts by setting a 
variable called PAGE to the OSHWM. The start of video display 
memory is stored in a variable called HIMEM which changes 
with the screen mode selected. 

The OSHWM is initialized on reset (BREAK) to a value which 
depends on the combination of sideways ROMs fitted. Table 5.1 
shows some typical combinations. 

Table 5.1 RAM Allocation for Sideways ROMs 


Configuration OSHWM 

(PAGE) 

MOS + Basic &E00 

MOS + Basic + NFS &1200 

MOS + Basic + NFS + Printer Server &1400 

MOS + Basic + DFS &1900 

MOS + Basic + NFS + DFS &1B00 

MOS + Basic + NFS + DFS + Printer Server &1D00 


To find the value of PAGE: 

1. Press the BREAK key. 

2. If the BBC Basic message and prompt is not displayed, 
type: 

*BASIC 

3. Type: 

PRINT ~ PAGE 

Some programs will work only if loaded at a particular memory 
address. Basic programs load at the address stored in PAGE. If 
HIMEM is too low, strange patterns may appear on the screen as 
the program overwrites part of the screen memory. If this does 
not happen, you may find that a program loads correctly but stops 
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with the error message 'No room’. If these problems cannot be 
solved by changing to a screen mode which uses less memory, you 
will have to move the program down in memory. Some program 
files contain machine code as well as the Basic program. Usually, 
these will only work at a particular part of memory. If the 
program was written on a computer where PAGE is lower than in 
your own system it must be loaded at a 'safe’ area of memory 
(above the OSHWM) and then moved down to the correct address. 
This technique usually will corrupt the system workspace. 
Therefore, the program cannot use the filing system after 
relocation. Also, the computer should be hard reset after the 
program has finished by pressing CTRL-BREAK. 


REVIEW 

Other than for the most trivial tasks, most users make regular 
use of the file server. This chapter has introduced a number of 
commands and utilities which are used to examine, load and 
create files. Frequent use has been made of the hexadecimal 
number system in this chapter. If you don’t feel confident about 
using ASCII codes and hexadecimal numbers, you should refer to 
Appendix B. There are other texts which describe them in more 
detail (such as the BBC User Guide). Commands introduced in 
this chapter included *INFO and *EX which display the directory 
information for the specified file or files and the *RENAME 
command which allows the owner to change file names and to 
move file entries from one directory to another. 

As a practical example of how file information is used, a method 
for transferring cassette files to disk was described. The *LOAD 
command was used to transfer the file into a specific area of 
memory after using the *OPT 1,2 command to find the correct 
load parameters. The file information was displayed when the file 
was loaded. This information was then used to *SAVE the file on 
the file server. There have been several magazine articles about 
this important topic. Also, programs are available which may 
simplify the task. There are many different obstacles that may be 
encountered in transferring cassette files to disk and file server. 
If commercial transfer programs cannot assist, you may be forced 
to pull the program apart and develop other methods, such as the 
one described in this chapter. 
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COMMUNICATING 
BETWEEN STATIONS 


In Chapter 1, the three main t5^es of network communications 
were introduced. These are: 

• Workstation to file server 

• Workstation to printer server 

• Workstation to workstation 

This chapter deals with the Econet as a communication medium 
between user stations. Sections of the NFS software perform the 
basic tasks of transmitting and receiving information across the 
network. They are called the NFS low-level primitives. The 
Econet Advanced User Guide describes how to use these in your 
programs, should you wish to create your own communications 
utilities. To use them effectively requires some understanding of 
assembly language programming. This chapter does not include a 
description of their operation as it is beyond the scope of the book. 
However, it is well covered in the Econet manuals. We shall 
concentrate on the utilities provided by Acorn on the file server 
disk. These programs use the system primitives and have been 
designed for ease of use. 

Let’s begin by considering how we could use station-to-station 
communications. An Econet cable may be up to one kilometer 
long. (Although Acorn Computers now recommend that the limit 
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is 500 meters, there are several operational systems using one 
kilometer of cable.) The system supervisor may wish to advise all 
users that the system is about to be shut down. Over such long 
distances, the obvious communications medium is the Econet 
itself. The *NOTIFY utility allows messages to be sent to other 
stations. If the supervisor wishes to see which stations are in use, 
the *VIEW utility displays a copy of the screen of another station. 
It could also be used where a supervisor or instructor wishes to 
have a group see the same information at their individual sta¬ 
tions. Finally, users can receive assistance to perform a task on 
their own computer from any other user on the network using the 
*REMOTE utility. The keyboard is disabled and the station 
providing assistance acts as if it were a terminal to the station 
being controlled. 

There are three more utilities associated with network communi¬ 
cations. To end a REMOTE session, the user at the controlling 
station types *ROFF. This program terminates the activity and 
returns control to the keyboard of the receiving station. On many 
systems, you will find that some or all of these utilities are not 
available. In the wrong hands, they could prove to be a nuisance 
to other users. However, if they are available on your system and 
you don’t wish to be interrupted, you may prevent other stations 
from communicating with you by typing *PROT. This is cancelled 
by typing *UNPROT. All of these utilities would be found in the 
library (with access of RL/R) if they are available to you. 


SENDING MESSAGES 

The NOTIFY command is followed by a station number or the 
USERID of another user (who is logged-on to the same file server 
as yourself) and then by the message to be transmitted, for 
example: 

>*NOTIFY 10 Please come to the office 
or 

>*NOTIFY MARY Please finish up now 

The destination stations would receive the message preceded by 
the sender’s station number: 
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>-113: Please come to the office- 

If MARY was typing when the message was transmitted, the text 
would he added to the end of the line. However, no carriage 
return would be sent so she could delete the text from the line: 

>CHAIN "$.BRIAN.R-113: Please finish up now- 

If the destination station is not connected or if the machine is 
protected, the 'Not listening’ message will be displayed. A 
broadcast to all stations on the network is not supported by the 
NOTIFY utility. Therefore, to communicate with every station on 
the network, you must NOTIFY each one individually. 

There are two potential problems with this. First, the data may 
be accepted for input by a program, running on the receiving 
station. This could upset important work. It can be avoided by 
first viewing the user’s screen to see whether he or she would be 
disturbed by your transmission. Second, since the text sent by the 
NOTIFY utility is inserted into the keyboard buffer, the message 
would be lost if a program in the receiving station flushed the 
keyboard buffer before reading the keyboard. There is no way to 
override this. Therefore, if it is mandatory that the message gets 
through, it is advisable to VIEW the receiving screen after 
sending the message to verify that it was received. Alternatively, 
REMOTE the other station and force a message through. 


VIEWING OTHER STATIONS 

The VIEW utility allows you to take a 'snapshot’ of another 
station’s screen. The command is followed by the station number 
or the USERID of another user (who is logged-on to the same file 
server as yourself). For example: 

*VIEW 10 
or 

*VIEW BRIAN 

The VIEW utility is loaded from the CSD or CSL and control is 
transferred to it. The program functions by copying the video 
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display memory from the destination station into its own. The 
effect of this is to copy the screen image. If the station being 
viewed is in a screen mode which uses more memory than the 
station sending the request, an error is returned. For example, if 
a station in screen Mode 4 attempted to VIEW a station in screen 
Mode 1, the screen would display the error message: 

>*VIEW 123 

Mode 1 

> 

This is done to prevent users from losing valuable programs or 
data if the screen were to change unexpectedly. We can create 
'moving pictures’ by repeating this quickly, in the same way as 
cartoons are made. This gives a close copy of the station being 
VTEWed. The time taken to transfer one screenful of data is 
twenty times longer for Mode 0 than for Mode 7, since there is 
twenty times as much data to transfer. Therefore, the moving 
image is much better in screen modes which use less memory. 

Program 1 shows a simple program to provide continuous display 
of another station. The first line loads and executes the VIEW 
utility. The second line returns to repeat the process. This 
program is not well designed since the VIEW program is reloaded 
from the disk on each pass. This would keep the disk drive 
running continuously. 

Program 1: 

10 *VIEW 15 

20 GOTO 10 

Program 2 is an improvement on Program 1. In the first line, the 
VIEW utility is loaded into memory and the station number to be 
VIEWed is stored. Inside the loop, the VIEW program is executed 
directly by the CALL statement in line 20. The program will run 
faster since the program is not reloaded on each pass. The current 
entry point is at location &E5D; however, this may change with 
new releases of the VIEW utility. If this occurs, you will need to 
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find the start point in the new VIEW program after it has 
checked the destination station number. 

Program 2: 

10 *VIEW 15 
20 CALL &E5D 
30 GOTO 20 

This program would work provided that the station being 
VIEWed did not select a screen mode which required more 
memory than was used by the screen mode of the VIEWing 
station. If the screen mode of the station being viewed requires 
more memory than the viewing station’s screen has available, the 
program must trap the error condition, find the mode of the 
machine and change to the new screen mode. Program 3 does this 
in the section of the program which is called by the ON ERROR 
statement. The operating system call (OSWORD) returns the 
new screen mode. The next line changes the screen mode before 
returning to the main part of the program. 

To make this really useful, we need to be able to enter the station 
number or USERID of the station to be viewed, from the 
keyboard. This is passed to the VIEW command by the operating 
system command line interpreter (OSCLI). Note that the address 
of OSCLI is included to allow for stations with Basic 1.0 fitted. Do 
not use uppercase letters for the variable name (OSCLI) as this is 
a command in Basic 2.0. The program ends by typing zero for the 
station number. 

Program 3: 

10 ON ERROR GOTO 110 
20 DIM X% 10 
30 Y% = X% DIV 256 

40 osword = &FFF1 : oscli = &FFF7 : vustrt = &E5D 
50 INPUT "Station number ” stat% 

60 IF stat% = 0 THEN END 
70 $X% = "VIEW” + STR$ (stat%) 

80 CALL oscli 



90 CALL vustrt 
100 GOTO 90 

110 IF ERR <> &AD THEN REPORT : END 
120 A% = &13 : ?X% = &0A : CALL osword 
130 MODE (X%?1) 

140 GOTO 90 

This final version of the program is a full screen monitor. It could 
be extended to display a list of stations on the network and wait 
for the user to enter the number to be VIE Wed. SCANNER or a 
program like it is probably available on your system. If you are 
unsure, check with your system supervisor. 


CONTROLLING OTHER STATIONS 

The *REMOTE utility is mainly intended to allow supervisors to 
give assistance to inexperienced users. It could be used to develop 
interactive software such as games which use more than one 
station. The command is followed by the station number or 
USERID of another user (again who is logged-on to the same file 
server as your own). For example: 

*REMOTE 123 

> 

or 

^REMOTE JIM 

> 

When a REMOTE call is executed, a carriage return is printed at 
both computers, however the main indication at the receiving 
station is that the keyboard is disabled. The machine calling the 
REMOTE utility functions as though it were a terminal to the 
station whose keyboard is disabled, except for the BREAK key. 
Pressing the BREAK key will interrupt the link, but it will not 
sever it completely. To the controlling station, the main indicator 
of a REMOTE operation is that it receives a copy of all output to 
the screen of the station being controlled. To terminate the 
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operation, type *ROFF at the controlling station. This severs the 
link between the two stations and returns full control to the 
keyboard of each station. The command appears on the screen of 
both computers. 


NOT COMMUNICATING BETWEEN STATIONS 

It may be that your system has some or all of these communica¬ 
tion utilities available to you. If this is the case, what do you do to 
protect yourself from unwanted interruptions? All communica¬ 
tions on the network depend on stations setting up the pathway 
to allow it. Normally your computer is set up to respond to VIEW, 
REMOTE and NOTIFY. However, your system supervisor may 
have set up your station so that you are protected. To stop com¬ 
munication with your station, type *PROT. To enable communi¬ 
cations type *UNPROT. A station which attempts to *NOTIFY a 
protected station will receive the error message: 

Not listening 

> 

Attempting to *VIEW or *REMOTE a protected station will 
cause the requesting station to lock-up. In this state, it will only 
respond to an ESCAPE or BREAK key. 


REVIEW 

One of the main advantages of local area networks over 
standalone microcomputers is the great potential that station-to- 
station communications offers. Many companies have installed 
integrated computer networks which link together areas such as 
production, stock control, warehousing and marketing. Electron¬ 
ic mail improves the quality of communications within organiza¬ 
tions, usually at much less cost than other systems. Also, many 
local networks link to national and international systems. The 
Econet has the capacity to perform all of these tasks. 

Future Econet developments will produce more sophisticated 
electronic mail systems. The communication utilities provided 
with the system allow stations to copy other screens, to send 
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messages and to take control of other stations. In addition, there 
are programs which allow users to lock out and to restore 
communications with other stations. The NFS has a number of 
program modules called low-level primitives. These provide the 
means for system programmers to develop more sophisticated 
communications software such as electronic mail. The Econet is a 
fast and efficient communications channel with extraordinary 
potential for future development. 



7 

USING THE PRINTER 
SERVER 


An important feature of LANs is their ability to share printer 
resources. The station providing this facility is usually called the 
PRINTER SERVER. There are three elements to a printer 
server: a workstation with a printer attached and the printer 
server software installed as a memory chip in a sideways ROM 
socket of that station. Print serving is not a dedicated task for 
this station — that is, it can continue to function as a user 
station. The printing is performed as a BACKGROUND TASK 
(refer to Chapter 1). 

To use this facility, you must first know how to select printer 
servers from your station. You may also need to initialize the 
printer server. Wherever one printer is shared by several users, it 
is important that the owner of each print job is clearly identified. 
The Econet printer server software will display a header message 
(the BANNER) automatically, each time the printer is selected. 
It can also print a message at the end of each print run (the 
ENDTEXT). This chapter describes these operations. 

THE ECONET PRINTER CHANNEL 

There are a number of methods of connecting printers to the BBC 
Microcomputer. These include the parallel printer port, the serial 
RS423 port, the Econet printer server and the 1-MHz Bus (with a 
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user-defined printer driver). A channel number is associated with 
each method of printing. The channel number is selected by the 
*FX 5,n command. Options include: 

*FX 5,0 

Printer sink (text not printed) 

*FX 5,1 

Parallel printer (selected on power-up and 
CTRL-BREAK) 

*FX 5,2 

Serial printer (via the RS423 port) 

*FX 5,3 

User-supplied printer driver 

*FX 5,4 

ECONET PRINTER SERVER 

*FX 5,5-255 

User-supplied printer driver 


Another way printed text can be handled is through the printer 
sink. Text to be printed is sent to a 'black hole’, never to be seen 
again. This is useful when running programs which always 
output text to the printer; whether you need it or not! Before you 
can send text to a printer server, you must set the printer channel 
at your station by entering the command: 

>*FX 5,4 

> 

After this, the operating system sends all text for printing to the 
printer server, via the network filing system. The Econet printer 
channel will remain selected unless changed by another *FX5 
command or by pressing CTRL and BREAK at the same time (a 
hard reset). 


THE PRINTER SERVER STATION NUMBER 

The NFS must know which station to send printer requests to. If 
your network has only one printer server, this is no problem. All 
stations are initialized to expect a printer server on station 
number 235 on power-up and after a CTRL-BREAK. Therefore, 
the first printer server installed in a network is usually set as 
station number 235. If your network has more than one printer 
server, the station number of other servers can be selected by 
entering the command: 


*PS n 
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where n is the station number of the new printer server. PS is a 
utility program which is usually stored in the LIBRARY. Thus, 
you must be logged-on to the file server before using this 
command. The program stores the number n in memory using an 
operating system OSWORD call. 

Where a network has multiple file or printer servers, it is good 
practice to number the stations in descending order. Thus for 
printer servers, the stations would be numbered 235, 234, 233,... 
while file servers would be 254, 253, 252,.... 


STARTING TO PRINT 

So far we have seen how to select the printer server channel and 
destination server number at a workstation. To start printing, 
the operating system must be instructed to request access to the 
printer server. Printing is started by sending a byte with the 
value two to the OSWRCH routine. This is the same for all types 
of printers. This can be done by t 5 q)ing CTRL-B. 

Basic programs use the 'VDU 2’ or 'PRINT CHR$(2)’ statements 
to achieve the same result. A byte with the value two tells the 
OSWRCH routine to send text to the printer as well as to the 
screen. The operating system also sends a request to the printer 
server for access. If the printer server is available, a reply will be 
sent back to the station to start sending text for printing. In 
addition, if the printer server is set up to print a message at the 
start of each print job (a banner), this is done. 

If the printer server program is not running, if another job is 
being printed, or the station is not connected to the network, the 
'Not listening’ message will be returned. After selecting the 
printer server, it is used in the same way as a printer connected 
directly to a BBC Microcomputer. 


ENDING A PRINT JOB 

After finishing a print job, the task is completed by typing 'CTRL- 
C’. Basic programs use the 'VDU 3’ or 'PRINT CHR$(3)’ state¬ 
ment. A byte with the value three tells the OSWRCH routine to 
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stop sending text to the printer and to send a message to the 
printer server via the NFS to release the printer. Also, if the 
printer server is set up to print a message at the end of each print 
job, this is done. 

To overcome the problem of users selecting the printer and then 
forgetting to release it, the printer server will 'time out’ if it is not 
used for 30 seconds. After this, a user will lose access to the 
printer if another user requests it. If this occurs, the current print 
job is terminated correctly and a banner is printed for the new 
job. If the timed-out station sends text to the printer before 
another station requests access, the time-out will be cleared and 
the timer reset. 


THE PRINTER IGNORE CHARACTER 

The BBC Micro can prevent a preset character from being sent to 
the printer. For example, many printers do not require a line feed 
to be sent after a carriage return. The machine always assumes 
that this type of printer is connected, after a hard reset. If you 
have a printer which requires a line feed to be sent, you must 
instruct the OSWRCH routine to stop filtering out the line feed 
code (ASCII 10). The way to do this is to change the filter 
character using the *FX 6 command. The character set by this 
command is never printed. The null character is seldom sent to 
printers so it is a good choice. It is set by typing the command; 

>*FX 6,0 

> 

If required by the printer, the command must be entered at each 
station which uses the printer server. For more information 
about the printer ignore character, refer to the BBC Microcom¬ 
puter User Guide. 


USING THE PRINTER SERVER AS A STATION 

When switched on, the printer server software is not executed 
although two pages (512 bytes) of memory are reserved for 
workspace. The program is started by executing the *PSERV 
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command. This initializes the printer server and then retxirns 
control to the 'foreground task’, that is, the program running 
when the PSERV command was given. After this, you may use 
the computer in almost the same way as any other station. The 
main difference is that the computer is interrupted 50 times per 
second. Each time this happens, control is transferred to the 
printer server program (the background task) for a few thou¬ 
sandths of a second. The printing task is serviced and then 
control is returned to the user’s program (the foreground task). To 
a user working at the station, the change in the speed of his or her 
program is negligible. 

Other than a small reduction in user memory (usually 512 bytes), 
the main point to watch is in the use of the BREAK key. If it is 
pressed when a print job is being executed, it is impossible to 
recover. For this reason, some users have fitted a small switch 
opposite the TUBE connector under the computer’s keyboard. 
This switch cuts the line to the BREAK key, preventing 
accidental BREAKs. In the current version of the software (1.00), 
the user at a station which is running as a printer server cannot 
use his or her own printer or another printer server. Normal 
practice is to stop the printer server program when it is not in use 
(by pressing the BREAK key). The printer is then used in local 
mode. 


STARTING THE PRINTER SERVER 

The printer server software is usually only executed at the start 
of the day’s processing by the system manager. However, there 
may be times that a user needs to change the print options. An 
overview of the commands is included. Note that this facility is 
provided as a service to all users on the network. It should not be 
changed unless there is a need to do so. 

A printer server is a station which has a printer attached and is 
fitted with a sideways ROM containing the printer server 
program. To find out if a station contains the ROM, type *HELP. 
The message 'Printer Server x.yz’ (where x.yz is the version 
number) will be included in the displayed list if the software is 
present. At the time of writing, the released version is 1.00. 
Before starting the program, make sure that the correct printer 
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channel is selected. If the printer uses the parallel port (*FX 5,1), 
this is set automatically on a hard reset. If a serial printer is used 
(*FX 5,2), you must also ensure that the correct data transmit 
rate is set (*FX 8,n). For more information about selecting 
printers, refer to the BBC Microcomputer User Guide. To start 
the printer server, type: 

>*PSERV 

> 

A number may he included in the *PSERV command which sets 
the format of the banner for certain printers. For example, if an 
Epson printer is attached to the station, the command should be: 

>*PSERV 2 
> 

The current list of printers and their associated numbers is: 

0 The default — banner format not preset 

1 Olivetti JPlOl 

2 Epson 

3 Walters Microsystems WM2000 

4 Mannesmann Tally MT180 

5 Mannesmann Tally MT140 

6 MPI 88(G), 99(G) and 150(G) 

7 Florida Data Corporation BNY 

The effect of including these numbers is to set the PRE, POST 
and ENDTEXT parameters which are described in the following 
sections. 


SETTING THE BANNER 

On large networks, there may be 30 or more users sharing the 
same printer server. A system is needed to identify the owner of 
the text being printed since it will come out in a continuous 
stream. When a request for access is accepted by the printer 
server, a message is usually printed on the first page to identify 
the owner of the print job. This message is preset using the 
*BANNER, *PRE and *POST commands at the printer server 
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station. Alternatively, the *NOBANNER command stops the 
header being printed. 

The format of the banner is determined by the preset text (using 
*BANNER) and the printer control codes (using *PRE and 
*POST). Many printers have special features such as the ability 
to print large text. These features are usually set by sending 
ASCII characters called 'Escape codes’ to the printer. The *PRE 
command is used for this purpose. Following this, the ^BANNER 
command sets up the header text to be printed. Finally, the 
printer is reset to its normal format to print your job and the 
paper is moved forward. This is done using the *POST command. 
Unless the banner is disabled (using *NOBANNER), the station 
number will also be printed. The format of the header is as 
follows: 

(PRE text) (BANNER) ** Station nnn ** (POST text) 

where nnn is the station number of the machine requesting the 
print job. If the printer server software is initialized using 
*PSERV or *PSERV 0, the settings will be: 

PRE text null (send nothing) 

BANNER Econet ’ 

POST text carriage return and line feed 

If station number 173 requested printer access, one line of text 
would be printed at the beginning of the print run: 

** Econet ** Station 173 ** 

The station’s print job would start on the line immediately 
following the header. To make the banner appear on a page by 
itself, control characters are included in the *POST command. 
Control characters are programmed using the same method as 
described for function keys in Chapter 25 of the BBC Microcom¬ 
puter User Guide. Most printers accept a FORM FEED command. 
This moves the paper to the start of the next page (head of form). 
To program this, preceded by a carriage return for the end of the 
line of header text, the command is: 


>*POST |M|L 
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The most common control characters are: 


Command Abbreviation Description 


|I HT 

|J LF 

|L FF 

|M CR 

][ ESC 


Horizontal tabulation 
Line feed 
Form feed 
Carriage return 
Escape 

Set the most significant bit of 
the next character sent 


The escape codes to preset the Olivetti JPlOl printer for double 
width and double height are: 

ESC 3 ESC’ 

If this is sent as a *PRE command, the banner will appear in 
large text. The command is: 

>*PRE |[3|[’ 

> 


A typical banner would include the date and perhaps the name of 
the site: 

>*BANNER "|M 25 September 1983iM SPREYTON 
PRIMARY SCHOOL|M” 

> 

Notice that carriage returns are sent before and after each line of 
text. No line feeds were sent as the JPlOl printer always 
performs a line feed after a carriage return. Finally, the double 
size printing must be returned to normal and a few line feeds 
(using carriage returns) sent to separate the banner from the 
print job. The *POST command is used for this: 

>*POST |[4i[%|M|MiM 
> 

Using this command sequence, the text sent to the printer would 
be: 
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ESC 3 ESC ’ CR 
25 September 1983 CR 
SPREYTON PRIMARY SCHOOL CR 
ESC 4 ESC % CR CR CR 

where CR = carriage return and ESC = escape. At the end of the 
print job, it is normal practice to send a form feed to ensure that 
the next job starts at the top of the page. The end sequence is 
programmed using the *ENDTEXT command. A message may 
also be included which indicates the end of the job. For example: 

>*ENDTEXT |M|M|M|[3|[’ 

END OF PRINT RUN|M|[4|[%|L 
> 

This will print the 'END OF PRINT RUN’ message in large type, 
three lines down from the last line of the print job. It will then 
slew the paper to the top of the next page. A sample print run 
would look like this: 


25 September l?83 
5FREVT0N PRIHI^RV SCHOOL 
H Station 173 


A HAIRY STORY 

Once upon a time, there were three 
bears; poppa Bear, Momma Bear and Boby 
Beor. Poppa Bear had thick wiry hair. 
Momma Bear had soft sleek hair. But 
Boby Bear had no hair at all. So they 
called him Fwed Bear? 


END OF PRINT RUN 
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The BANNER, ENDTEXT and POST fields may contain up to 64 
characters. The PRE field may contain up to 30 characters. 
Control characters such as ESC (|[) are stored as one character 
only. 


DEFAULT PRINTER SETTINGS 


If you have one of the printers listed in Table 7.1, you may use 
standard PREtext, POSTtext and ENDTEXT escape codes by 
following the *PSERV command with a number which relates to 
the printer type; for example, *PSERV 1 selects the Olivetti JP 
101 codes. 


Table 7.1 Printer Defaults 


Printer 

No. PREtext 

POSTtext ENDTEXT 

Default 

0 

|M|J 

L 

JPlOl 

1 |[3|[’ 

|M|[4|[%|M|JiM|J 

J|J|J|J|J|J|J|J|J 

Epson 

2 |N 

M|T|M|J|M|J 

L 

WM2000 

3 |[|0 

|M|[|N|M|J|M|J 

|L 

MT180 

4 |[[0w 

|M[[4w|M 

|L 

MT140 

5 N 

|M|0|J|M 

|L 

MPI 

6 |[|N 

M|[|0|M 

L 

BNY 

7 |[[2C 

|M|[[1C 

|L 


NO BANNER OR ENDTEXT 

There are times when you may not wish to have a header or 
footer; for example, if you are using a word processor with single 
sheet feeder, the program will end the print job at the end of each 
page. It then sends a message to the screen to change the paper 
and then reselects the printer. If bannering is not disabled, 
printed documents will be filled with unwanted banners. This is 
overcome by entering the following commands: 


>*NOBANNER 

>*ENDTEXT 

> 
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REVIEW 

The concept of networking developed so far is that computers can 
share resources if they have the ability to communicate. In 
computing, one of the most valuable resources is printing 
facilities. The Econet printer server offers high-performance 
print-sharing for the cost of some ROM software only. Its 
commands are easy to learn and provide the system with features 
that are usually found only on much larger systems. 

This chapter has described how to use the printer server. This 
involved three main areas. First, each station has the ability to 
communicate with the printer server if commanded to do so, 
using the *FX 5,4 command. The printer ignore character must 
be changed for some types of printers, using the *FX 6 command. 
Also, to access the printer server from a station, the command is 
the same as with a local printer (using CTRL-B). Second, the 
printer server station software must be initialized using the 
*PSERV command. It may also require setting up the banner text 
to be printed at the start and end of each print job using the 
*BANNER, *NOBANNER, *PRE, *POST and *ENDTEXT com¬ 
mands. Finally, the printer server station may be used as a 
workstation at the same time as it is printing text for other users. 
This requires some knowledge of the effects of the printer server 
software on the normal operation of the station. 


NBM-G 
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PROCESSING STAR 
COMMANDS 


This chapter provides a brief description of how commands and 
utilities are processed by the BBC Microcomputer. The list 
includes; 

• Machine Operating System (MOS) commands 

• Network Filing System (NFS) commands 

• File Server commands 

• File Server Utilities (FSUTILS) 

• Disk Filing System Utilities (UTILS) 

The MOS commands are common to all BBC Microcomputers, 
regardless of which filing systems may be resident. NFS 
commands are available in all Econet workstations. File server 
commands are passed to the selected file server by the NFS for 
processing. FSUTILS are utility programs, stored in the file 
server, available to all workstations with read access to the files 
in which they are stored. UTILS are available to all workstations 
in which a DFS is co-resident. On some systems, versions of the 
UTILS may be implemented as FSUTILS. In this case, access will 
depend on the user having access to the files in which the 
programs are stored. The *HELP command (described in Chapter 
2) shows what ROM-based system software is resident. 

Let’s begin by seeing how commands are processed by the 
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workstation. In all of the examples described in this text, we have 
assumed that the user is working with the BBC Basic interpreter. 
This is indicated by the Basic prompt > which appears at the 
start of every new line when in the command mode. It may be 
that the user is working with other software such as Acornsoft’s 
VIEW word processor or a language such as Lisp or Forth. The 
BBC Microcomputer has been designed so that any applications 
software may easily integrate operating system commands. The 
Acorn designers have devised a convention for passing operating 
and filing system commands to the MOS for processing. The 
convention used is to precede system commands with an asterisk. 
For example, the Basic interpreter knows that all commands 
preceded by an asterisk are to be passed directly to the MOS. 

Figure 8.1 shows how ROM software is organized in the BBC 
Microcomputer. At the center is the operating system kernel. 
This provides the pathway for the flow of commands. Co-resident 
with the operating system in the MOS memory chip are the 
cassette filing system (CFS) and the ROM filing system (RFS). 
The CFS is selected on any BBC Microcomputer by typing *TAPE 
or *TAPE3 (for 300 bits per second operation), or by holding down 
the space bar and BREAK key together. The RFS is selected by 
typing *ROM. 

The area of memory, immediately above the screen memory, has 
been designed to allow up to 16 programs to be co-resident. This 
part of memory is called the sideways (or paged) ROM area since 
memory expands 'sideways’ to a maximum of 256K bytes using a 
technique called PAGING (Figure 8.2). Only one program may be 
accessed at a time. Page selection is controlled by the MOS. 
Except for the MOS, all of the programs in Figure 8.1 reside in 
the sideways ROM area. These programs can be grouped by the 
type of function that they serve. There are filing systems, 
languages, hardware drivers and utilities. Basic, View and Forth 
are examples of language ROMs. The NFS and DFS are filing 
systems. A filing system is a program which saves and loads files 
on an external device. Peripherals which require special hard¬ 
ware drivers (perhaps connected to the 1-MHz Bus) could have 
the software stored in a sideways ROM. Software may be 
configured as a utility ROM. Programs such as a Graphics 
Extension ROM (which extends the graphics commands of the 
MOS) would be in this category. 
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Figure 8.1 Organization of resident system software 
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Figure 8.2 Layout of sideways ROM area 
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While there may be several co-resident filing systems in a BBC 
Microcomputer, only one may be selected at a time. This is called 
the Currently Selected Filing System (CSFS). You will recall that 
we may also have a Currently Selected Directory (CSD) and a 
Currently Selected Library (CSL) within some filing systems. 
Let’s examine how some of these commands and utilities are 
processed. In the following examples, we shall assume that the 
currently selected language is Basic and the CSFS is the NFS. All 
commands are entered in the command mode. 

One of the most commonly used commands is *CAT. When the 
user types this, the Basic interpreter passes the command to the 
MOS. Since the command requires access to an off-line storage 
device, the MOS transfers control to the CSFS (i.e. the NFS) for 
processing. A key feature of the BBC Microcomputer is the way 
that communication between the computer and 'the outside 
world’ is handled by the MOS. For example, after the NFS has 
found what flies are in the directory, the information is displayed 
on the screen by the MOS. The keyboard is read; graphics and 
text are displayed on the screen; music is generated by the music 
synthesizer; data is sent to the printer; the speech synthesizer 
speaks to us; and so on — all at the direction of the MOS. 

Language and filing system ROMs are normally called by a 'star’ 
command. For example, *DISC (pronounced star disk) changes 
the CSFS to the DFS if it is resident in the machine. Thereafter, 
all commands to be processed by the CSFS are passed to the DFS. 
Language ROMs may also be selected in this way; for example, to 
change from Basic to Forth, type: 

>*FORTH 

BBC Forth Copyright 1983 


The currently selected language would become Forth. No further 
Basic commands would be recognized until Basic was reselected. 
To do this type: 

:*BASIC 
BBC Basic 
> 
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If BBC Basic is the language available when the computer is first 
switched on, it may also be recalled by pressing the CTRL and 
BREAK keys together. 

Utility ROMs could be called by language ROMs to extend the 
system’s capabilities; for example, a Graphics Extension ROM 
would add extra graph plotting facilities to the machine. Basic’s 
PLOT commands are processed by the MOS. The t5^e of PLOT 
statement to be executed is selected by the number which 
immediately follows the command. Some of these numbers have 
been reserved for graphics extensions and would be located in a 
utility ROM. So PLOT 66,150 could mean 'plot a circle with a 
radius of 150 with its center at the graphics cursor’. 

Some commands are executed by the MOS only. For example, 
*FX 0 returns the version number of the MOS and the *MOTOR 
command switches the cassette motor relay. If the MOS does not 
recognize the command in its own command list, it next checks 
the sideways ROMs. Data may be incorporated in the ROM which 
allows it to be executed by a star command. Some of the ROMs 
which may be called include: 


*BASIC BBC Basic interpreter 


*DISC or 
*DISK 

^TERMINAL 

’"NET 

="PRESTEL 

="PSERV 

’"TELETEXT 

’"WORD 

="WORDWISE 


Disk filing system 
Terminal emulator 
Network filing system 
Prestel filing system 
Printer server 
Teletext filing system 
VIEW word processor 
WORD WISE word processor 


If the command is not recognized by any of the sideways ROMs, 
the MOS passes the command to the CSFS (in this case, the NFS) 
for processing. The NFS passes the command to the file server for 
processing. The file server first checks its own command table. If 
there is no match, it then searches for a file in the CSD with the 
same name as the command. For example, if a copy of the 
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machine code program NOTIFY was stored in the CSD and the 
user had read access to the file, it could be called by typing: 

>*NOTIFY 23 "Hello Fred! Come to lunch — Bob” 

> 

The station number (23) and the message, separated from the 
filename by at least one space, are passed on to the program 
(NOTIFY) when it is loaded into the calling station. Note that 
machine code programs called by star commands are loaded and 
executed at the addresses displayed by the *INFO or *EX 
commands. Care must be taken that utilities are not used which 
overwrite programs or data already in memory. Acorn’s 
FSUTILS are designed to load into a safe area of memory which 
user programs should never use. 

If a filename matching the command is not found in the CSD, the 
file server next checks the CSL. The concept of the CSL is to have 
an area on the disk where public access machine code programs 
are stored. By doing this, these files need only be saved once. This 
makes better use of the available disk space and simplifies 
loading of commonly used programs. For example, the FREE 
utility is a program which displays the names of the disks on the 
file server and the amoxmt of disk space remaining. Clearly, this 
program is of interest to most users. By storing the file in the 
library, all users have access for no extra effort. 

Note that files to be loaded using a star command must not be 
saved with filenames which match ROM commands. As an 
example, the Econet VIEW utility was written long before the 
word processor of the same name. This forced the designers to 
make the ROM call *WORD. If this were not done, the Econet 
utility could not be called as a star command by any machine 
which had the word processor fitted. 


REVIEW 

In this chapter, we have discussed the way that star commands 
are processed by the system. The BBC Microcomputer allows the 
user to treat operating and filing system commands and calls to 
language ROMs in the same format. In addition, machine code 
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programs stored in the Currently Selected Directory and Cur¬ 
rently Selected Library may be treated as system commands. 
This greatly simplifies program loading. When a star command is 
passed to the MOS for processing, there is a fixed sequence of 
steps. If the command is not recognized at any stage, a 'Bad 
command’ error code is returned. Figure 8.3 shows the steps that 
are taken to process the command. 



Figure 8.3 Processing star commands 
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ERROR MESSAGES 


The BBC Microcomputer operating system allows all software to 
handle system errors in a consistent way. This method may be 
used in your own programs. The technique is to execute a 
machine language BRK instruction. This transfers control to the 
system BREAK HANDLER. The handler expects to find data in 
memory, immediately following the BRK instruction. The format 
of this data is as follows: 

brkadd 00 BRK instruction 
XY Error number 


Error message 


OD 

00 

As an example, consider an electronic mail program which gen¬ 
erated an error number &97 and the message 'System offline’. 
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Normally we would use the break handler for processing errors in 
machine code rather than Basic programs; however it is useful to 
explain the technique. The program could look like this; 

10 REM Example of the BRK handler 
20 DIM brkadd% 25 


Main body of program 


2000 ?brkadd% = 0 

2010 brkadd%?l = &97 

2020 brkadd%$2 = "System offline” 

2030 brkadd%?23 = 0 

2040 REM code for RTS statement is &60 

2050 brkadd%?24 = &60 


3000 REM Off line error. Execute BRK instruction 
3010 CALL brkadd% 

3020 REM Program continues here 

In this example, line 20 allocates 25 bytes of memory for the error 
number and message. The address of the first byte is stored in a 
variable called brkadd%. Line 2000 pokes the number zero into 
memory at the address brkadd%. This will be seen by the 
computer as a BRK instruction when the Basic program makes a 
call to the system break handler through line 3010. The BRK 
instruction transfers control to the break handler which looks for 
an error number (set up by line 2010) and an error message (set 
up by line 2020) and terminated by a byte, set to zero (line 2030). 

Note that a carriage return is always added when data is stored 
using the string indirection operator. If there is no error message, 
the error number is immediately followed by a byte containing 
zero. The break handler returns control to the location following 
the zero byte. In this case, control is then returned to the Basic 
program through the return from subroutine (RTS) instruction. 
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The Basic program will continue at the statement following the 
CALL (line 3020). Thus, the error block looks like this: 


Break 

Instruction 


Carriage 

Retmn 




Having described the system error handler, we will investigate 
errors which are likely to be encountered at a workstation. Error 
numbers may range from &00 to &FF (0 to 255). In addition to 
errors generated within the station itself, external devices such 
as the file and printer servers can return error numbers, 
accompanied by an error message. The following list contains 
error numbers and their associated messages for the file and 
printer servers, the machine operating system (including the 
cassette and ROM filing systems), and the network and disk 
filing systems. This list was compiled by dumping the error tables 
of each program. 


Error 
Number 
Dec Hex 

Econet 

33 21 

PW file not 
found 

100 64 

All handles 
open 

160 AO 

Line jammed 

161 A1 

Net error 

162 A2 

Not listening 

163 A3 

164 A4 

No clock 

165 A5 

166 A6 

167 A7 

No reply 


MOS 
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168 A8 

F.S. Error xx 


169 A9 

Too long 


170 AA 

Wrong printer 
type 


171 AB 

172 AC 

Bad user name 


173 AD 

Mode X 


174 AE 

Not logged on 


175 AF 

Types don’t 
match 


176 BO 

Rename across 
discs 


177 B1 

Already a user 


178 B2 

PW file full 


179 B3 

Dir. full 


180 B4 

Dir. not empty 


181 B5 

182 B6 

Is a dir. 

Map fault 

183 B7 

Outside file 


184 B8 

Too many users 


185 B9 

Bad password 


186 BA 

Insufficient 

privilege 


187 BB 

Wrong 

password 


188 BC 

User not known 


189 BD 

Insufficient 

Not enabled 


access 


190 BE 


Catalogue full 

191 BE 

Who are you? 

Can’t extend 

192 CO 

Too many open 

Too many open 


files 

files 

193 Cl 

Not open for 
update 

File read only 

194 C2 

Already open 

File open 

195 C3 

Entry locked 

File locked 

196 C4 


File exists 

197 C5 


Drive fault 

198 C6 

Disc full 

Disc full 

199 C7 

Disc fault 

Disc fault NN 
atTT SS 

200 C8 

Disc changed 

Disc changed 

201 C9 

Disc read only 

Disc read only 
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202 CA 


Bad sum 


203 CB 


Bad option 


204 CC 

Bad filename 

Bad filename 


205 CD 


Bad drive 


206 CE 

Bad dir 

Bad directory 


207 CF 

Bad attribute 

Bad attribute 


208 DO 




209 D1 




210 D2 




211 D3 




212 D4 




213 D5 



Locked 

214 D6 

Not found 

File not found 

File not found 

215 D7 



Bad ROM 

216 D8 



Data? 

217 D9 



Header? 

218 DA 



Block? 

219 DB 



File? 

220 DC 



Syntax 

221 DD 




222 DE 

Channel 

Channel 

Channel 

223 DF 

EOF 

EOF 

EOF 


249 F9 

250 FA 

251 FB 

252 FC 

253 FD 

254 FE 

255 FF 



Language? 


Key in use 


Bad key 


Bad address 

Bad string 

Bad string 

Bad command 

Bad command Bad command 


What this list shows is that error numbers are allocated in blocks. 
For example, NFS error numbers range from &A0 to &A5. Many 
numbers have the same or similar meanings in different filing 
systems. This is particularly so for the numbers from &C0 to 
&CF. At the time of writing, the Winchester Disk Filing System 
(WDFS) is still under development and the error messages are 



101 


not finalized. However, its error number allocation is similar to 
the DFS. The main exception to this is a block from &90 which is 
peculiar to the Winchester system (e.g. &93 = 'Bad FCB’ and &95 
= 'Map full’). Finally, you can see that some of the MOS 
commands are unique to the cassette and ROM filing systems 
which are resident in the MOS while others (e.g. 'EOF’ ) are 
common to all filing systems. Not all errors are related to filing 
systems; for example, BBC Basic generates error numbers from 
zero to 44, as listed in Table 9.1. 


Table 9.1 Basic Error Messages 


0 

00 

Fatal error 

23 

17 

Accuracy lost 

1 

01 

Out of range 

24 

18 

Exp range 

2 

02 

Byte 

25 

19 

Bad MODE 

3 

03 

Index 

26 

lA 

No such variable 

4 

04 

Mistake 

27 

IB 

Missing) 

5 

05 

Missing, 

28 

1C 

Bad Hex 

6 

06 

Type mismatch 

29 

ID 

No such FN/PROC 

7 

07 

No FN 

30 

IE 

Bad call 

8 

08 

$ range 

31 

IF 

Arguments 

9 

09 

Missing " 

32 

20 

No FOR 

10 

OA 

Bad DIM 

33 

21 

Can’t match FOR 

11 

OB 

DIM space 

34 

22 

FOR variable 

12 

OC 

Not LOCAL 

35 

23 

Too many FORs 

13 

OD 

No PROC 

36 

24 

No TO 

14 

OE 

Array 

37 

25 

Too many GOSUBs 

15 

OF 

Subscript 

38 

26 

No GOSUB 

16 

10 

Syntax error 

39 

27 

ON syntax 

17 

11 

Escape 

40 

28 

ON range 

18 

12 

Division by zero 

41 

29 

No such line 

19 

13 

String too long 

42 

2A 

Out of data 

20 

14 

Too big 

43 

2B 

No REPEAT 

21 

15 

-ve root 

44 

2C 

Too many REPEATS 

22 

16 

Log range 





Most system errors are handled using the method described 
earlier in this chapter. A conflict arises when the file server 
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generates error numbers which could clash with non-filing 
system error numbers (e.g. Basic). To allow for this, the NFS 
contains a compound error number. If the error number is &A8, 
the message following the number may be the general file server 
error message. It takes the form 'F.S. Error xx’ where xx is the 
actual error number. In a few cases, the file server returns the 
&A8 error number with an error message which describes the 
actual fault. One example of this is error number &21. In this 
case the error message displayed is 'PW file not found’ though the 
error number returned is &A8. To find the file server error 
number when &A8 is returned, the user program must execute 
an OS WORD call to the operating system. The following program 
shows how this is done. 

10 REM Example program to trap file server error 
numbers 

20 DIM X% 10:Y% = X% DIV 256;osword = &FFF1 
30 ON ERROR GOSUB 1000 
40 


Main program 


1000 REM Trap correct error number 
1010 A% = &13 ; ?X% = &0A 
1020 CALL osword 

1030 IF X%?1 = &27 PRINT "Password file syntax error!” 
1040 RETURN 

This technique would only be used if a program needs to trap the 
actual file server error number. 

FILE AND PRINTER SERVER ERRORS 

There are many file server error messages which should never 
appear at a workstation. These should only occur when the file 
server is started and would be displayed on its own screen. One 
possible exception to this would be if the file server’s memory was 
corrupted. In any event, if you receive unknown error numbers. 
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the situation may be serious. Record the number and the 
circumstances which caused the error. Then report it to the 
system supervisor. Some of the errors described below may also 
be serious. Those marked with an asterisk should be reported 
immediately. No further work should be attempted at the station 
until the fault is cleared. 


* PW file not found 33 (&21) 

This message is displayed at the file server if it is started with 
disks which do not have a password file. The system manager 
should pick this up and replace one of the disks with one 
containing a password file. There is a second reason why this 
error may occur. If the disk containing the passwords file is 
changed to one without it, users already logged-on may continue 
their tasks. However, if a new user wishes to log-on, he will be 
unable to as the password information will no longer be 
available. 


All handles open 100 (&64) 

The maximum number of channels per user (including those 
allocated to the URD, CSD and CSL) is eight. The file server 
assumes that on average, users will never have more than three 
files open at the same time. Thus, the file server maintains a 
table allowing for an average of six channels per user. This error 
is generated if the average number of files per user is more than 
three. If this situation occurs, it may be overcome by specifying a 
larger number of users than will actually be required when the 
file server is started. If possible, this should be avoided as it 
wastes space which would otherwise be used by the cache 
memory. The file server cache memory holds data being transfer¬ 
red to and from the disk. The larger the system cache, the faster 
is the file server response. 


* Line jammed 160 (SiAO) 

A line jam occurs when a station attempting to transmit finds 
that the network has been carrying data continuously for about 


NBM-H 
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five seconds. The most likely causes are: 

• Shorted data lines (usually at a socket or in the con¬ 
necting lead to the computer) 

• Faulty network termination 

• A clock line shorted to a data line 

• A faulty computer 

• A station transmitting very large packets 

• Too many stations on the network trying to transmit or 
receive at the same time — sometimes associated with 
several stations transferring large blocks of data using 
the OSBPUT and OSBGET calls 

If the error occurs for even small amounts of data transmitted, 
the fault is probably a hardware problem. If the packets are too 
large, this would be due to the software and can be isolated by 
comparing it to other similar tasks. Finally, if there is an 
overload of traffic on the network, the system manager should 
analyze the tasks being run. In most cases, with proper planning, 
one can avoid this. 


* Net error 161 (&A1) 

A net error is usually due to abnormal transmission of the signals 
on the network. It is most likely to be caused by faulty term¬ 
ination. It could be due to a short circuit between the clock and 
data lines, causing the clock signal to be mixed with the data. The 
fault could also be due to the clock speed running either too fast 
or too slow for the network’s characteristics. 


Not listening 162 (&A2) 

This message may result from any type of network communic¬ 
ation. It occurs when the destination station is: 

• Not connected to the network 

• Switched off 

• Not set up to receive your transmission 
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There are two reasons why a station would not receive your 
transmissions. First, the station may not have been programmed 
to expect your type of transmission; for example, even though a 
station may have a printer server ROM fitted, if the program has 
not been executed by typing *PSERV, it will never know how to 
handle printer server requests, that is, it will ignore these 
packets. Alternatively, if the printer server is active and printing 
for one station, all other stations requesting access would return 
this error. Thus the requesting station will return the 'Not 
listening’ message. Second, a station may be programmed to 
ignore certain types of transmission; for example, the *PROT 
utility prevents the *NOTIFY utility accessing a station. Again, 
this will produce the 'Not listening’ error message. 


» No Clock 163 (&A3) 

The cable connecting the computers on the network carries a 
clock synchronizing signal, in addition to the data lines. If the 
clock signal is not received by a station, it cannot communicate 
on the Econet. The signal is checked when the station is first 
switched on, whenever the BREAK key is pressed, and whenever 
an attempt is made to transmit data. If a valid clock signal is not 
present, the 'No clock’ error is returned. If the fault is isolated to 
one machine, the problem may be due to a faulty station or to the 
cable connecting to the main cable. If no stations are receiving a 
clock signal, ensure that the clock/terminator is switched on and 
properly connected to the main cable. If there is still no clock, it 
will be due to a faulty clock/terminator, a fault in the main cable 
or possibly a faulty station which is shorting out the clock signal 
lines. If the clock cannot be restored, a service technician should 
be called. 


* No reply 165 (&A5) 

The 'No reply’ error occurs when a message has been successfully 
sent to another station and some return is expected but not 
received. The most common occurrence of this error is when a file 
server or printer server is stopped after receiving a request from a 
station. Make a note of which stations were involved and contact 
the system supervisor. 
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*F.S. Error XX 168 (&A8) 

As described earlier in this chapter, some error numbers cannot 
be handled directly by the station. Error &A8 is a composite 
number which flags the actual file server error number. The 
number can be found within a program by calling the operating 
system’s OS WORD routine, as described earlier. 

Too long 169 (&A9) 

There are too many characters in the *BANNER, *ENDTEXT, 
*POST or *PRE strings. The maximum length of each string is as 
follows: 

*BANNER 64 characters 

*ENDTEXT 64 characters 

*POST 64 characters 

*PRE 30 characters 

Wrong printer type 170 (SlAA) 

This error is generated if an invalid number is passed to the 
printer server when it is initialized. In version 1.00, any numbers 
greater than six would cause this error, e.g. *PSERV 7. 

Modex 173 (&AD) 

This error is returned when an attempt is made to view another 
station’s screen whose display mode requires more memory than 
the current mode of your own station. The memory required for 
each mode is as follows: 

Mode 

® 1 

1 20K 

2 J 


3 } 16K 



4 

5 
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I lOK 

6 } 8K 

7 } IK 

The 'Mode x’ error is generated to protect your station’s memory, 
when using the *VIEW utility. If you still wish to view the other 
station’s screen, change to the screen mode x and then repeat the 
*VIEW command. For example; 

*VIEW 16 

Mode 0 

>MODE 0 
>*VIEW 16 

This error may also be trapped within programs. For an example 
of this, refer to Program 3 in Chapter 6. 


Not logged on 174 (&AE) 

An attempt was made to refer to another user by a USERID 
which was not logged-on to your own file server. Commands such 
as '*VIEW FRED’ would generate this error if FRED was not 
logged-on to the same file server as the user station executing the 
VIEW command. 


Types don't match 175 (&AF) 

An attempt was made to use a name which already exists as a 
different object t 5 T)e. For example, you cannot type *CDIR FRED 
when a file named FRED exists. Another example would be if you 
tried to save file MARY when directory MARY exists. 


Rename across discs 176 (&B0) 

The *RENAME command changes a file entry. Not only will it 
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change an entry within a directory, it can also move entries from 
one directory to another, provided that the user owns both 
directories. In both cases, the file is unaffected. Only the entry 
changes. This error results from an attempt to rename a file 
across disk boundaries. This can only be done by copying the file 
to the new disk and then deleting the original file. 


Dir. full 179 (&B3) 

Directories have a limit to the number of file and directory 
entries which they may hold. To avoid this, it is a good idea to set 
up subdirectories according to the types of files being stored. This 
will also make directories more manageable. To find the 
maximum directory size, refer to the File Server User Guide. 


Dir. not empty 180 (&B4) 

An attempt was made to delete a directory containing file and/or 
directory entries. A directory must be unlocked and empty before 
it can be deleted. 


Is a dir. 181 (&B5) 

An attempt was made to load a directory into the station. A 
directory may be created or deleted and have file and directory 
entries added to it. Only files may be loaded into a station. 


Outside file 183 (&B7) 

When a file is opened as a random access data file, the file pointer 
may be moved. (Refer to the PTR# Basic statement in the BBC 
Microcomputer User Guide.) This error is returned if a program 
attempts to move the pointer past the end of file. 


Too many users 184 (&B8) 

The number of stations connected to the network is stored in the 
file server. This error is returned when an attempt is made to log- 
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on more stations than the file server was set up for. In this event, 
make sure that there are no stations logged-on but not in use. The 
file server regards stations which have their power disconnected 
without first logging-off as valid users. This can be cleared by 
switching the station on and then logging-off. If there are more 
users than were set when the file server was started, it must be 
re-initialized. After doing this, all users must log-on again. 


Wrong password 187 (&BB) 

This error indicates that the password entered in the '*I AM’ or 
'*PASS’ command does not match the USERID as stored in the 
file server. If repeated attempts to execute one of these commands 
fail, contact the system supervisor. 


User not known 188 (&BC) 

This error indicates that the USERID entered in the log-on 
command does not match any entry stored in the file server. If 
repeated attempts fail to log-on successfully, contact the system 
supervisor. 


Insufficient access 189 (8iBD) 

Creation, deletion, reading, writing and setting access levels are 
only permitted when the user has the correct level of access. This 
can depend on the level of ownership (owner or public) and the 
contents of the access string. This error is returned when a user 
attempts to perform tasks which are not allowed by the access 
string or for which ownership is required. For a complete de¬ 
scription of file access, refer to Chapter 4. 

Who are you? 191 (SiBF) 

An attempt was made to access a file server before logging-on. 
File servers store information about each user at log-on. In 
addition, each station stores information about the file server. 
Until logged-on, the only file server command accepted is '*I AM’. 
For further information, refer to Chapters 2 and 3. 
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Too many open files 192 (&C0) 

A user may have up to five files open at the same time. This error 
is returned when an attempt is made to exceed this number. As a 
general rule, it is good practice to close files which are not in use. 


Not open for update 193 (&C1) 

This error is returned when a station attempts to write to a file 
which has been opened for read only. If a program is expected to 
perform both read and write operations, it should be opened for 
update. 


Already open 194 (&C2) 

The file server allows a file to be open for read only by any 
number of users. However, it will only allow single user write 
access. This error is returned when an attempt is made to open a 
file for reading which is already open for writing. It is also 
returned when an attempt is made to open a file for writing which 
is already open. 


Entry locked 195 (&C3) 

An attempt was made to save data, to copy to, or to delete a locked 
file. This message is returned to the owner when the 'L’ character 
is set in the access string. A non-owner would have the 'Insuf¬ 
ficient access’ (&BD) message returned. 


Disc full 198 (&C6) 

This message is returned when an attempt is made to write to a 
disk which has no free storage space. If the operation was a file 
save, delete the file, select a new disk and then repeat the 
operation. If you are updating a data file, it may be necessary to 
copy the file to a new disk and if necessary, carry out some error 
recovery operation. It is good practice to check how much space is 
available on a disk (using the *FREE utility) before carrying out 
file updating as this can be most difficult to recover from. As a 
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general rule, avoid filling a disk to more than 90 per cent of its 
capacity. 


* Disc fault 199 (&C7) 

This message indicates that a system or disk media failure has 
occurred. Contact the system supervisor immediately. Although 
this error is uncommon, it is vital that backup copies of disks are 
made regularly to allow for this type of situation. 


Disc changed 200 (&C8) 

An attempt was made to access a disk which has been removed 
from the file server. To check the names of all disks on the file 
server, use the *DISCS or *FREE command. 


Disc read only 201 (&C9) 

Most forms of disk media allow the whole disk to be write- 
protected. This is in addition to file and directory locking. This 
error is returned when a write operation is attempted on a 
physically protected disk. If it occurs, contact the system su¬ 
pervisor immediately. It is most likely to occur after a disk has 
just been backed-up. 


Bad filename 204 (&CC) 

This error occurs when a filename has been incorrectly specified. 
The valid filename characters are listed in Chapter 8. Only these 
may be used when creating files. If accessing an existent file, 
check its name with the *CAT command. 


Bad dir 206 (&CE) 

This error occurs when a directory name has been incorrectly 
specified. Valid characters are listed in Chapter 10. Only these 
may be used when creating directories. If accessing an existent 
directory, check its name with the *CAT command. 
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Bad attribute 207 (&CF) 

This error is returned when an attempt is made to change the 
access string using incorrect characters. The valid characters are: 

Owner field of a file LWR 
Public field of a file WR 
A directory L 

In each field, one or all of the characters may be omitted. The 
public access field of a file must be preceded by the / character. 
Note that spaces included within or at the end of the string will 
cause this error to be returned. 


Not found 214 (&D6) 

This error is returned when the file server is unable to find the 
specified disk, file or directory. If this error is returned, check the 
name with the *CAT command; for example, this error would 
occur if the following command was entered: 

*DIR $.LIBRARY.DISCS 

where DISCS is a file entry in the directory LIBRARY. A 
common cause of this error message is at log-on when the auto¬ 
boot option is not set to zero and no file named IBOOT exists in 
the user root directory (refer to Chapter 3). Even though the error 
message is returned, the log-on is successful. The auto-boot 
option is disabled by executing the *OPT 4,0 command after 
logging-on. 


Channel 222 (&DE) 

Each station may have up to five files open. The system refers to 
these by a number (whose value is never zero) called the channel 
number. For example: 

luno = OPENIN "fred” 

opens the file 'fred’ and stores the channel number in luno. There 
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are also numbers associated with the URD, CSD and CSL. If a 
reference is made to an unknown channel number, this message 
is returned. It may also occur instead of the 'Who are you?’ error 
message. This usually results from switching the station off and 
then on again. It also occurs when the file server is stopped and 
restarted without first logging-off all stations. 

EOF 223 (&DF) 

This error occurs when an attempt is made to read past the end of 
a file. It is good practice to test for this in the program, for 
example: 

10 channel = OPENIN "data file” 

20 IF EOF# channel THEN PRINT "File Empty” : CLOSE 
# channel: END 
30 REPEAT 

40 a = INPUT# channel 

50 PRINT a 

60 UNTIL EOF# channel 

70 CLOSE# channel 
80 PRINT "Task Completed” 

Note that an 'End of file’ error would be returned when reading 
an empty file if line 20 were omitted. 


Bad string 253 (&FD) 

This error is generated when illegal characters are included in a 
string of text associated with a command. For example, *CDIR 
FRED% would return this error because the '%’ character is not 
valid in early versions of the file server software. Also, commands 
with mismatched quotes return this error, e.g. *BANNER 
"MONDAY. 


Bad command 254 (&FE) 

This error is returned if the star command is not recognized by 
the MOS, a sideways ROM or the file server and is not a filename 
in the CSD or CSL. For a full description of star commands, refer 
to Chapter 8. 
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REVIEW 

This concludes the description of error messages associated with 
the Econet. This chapter has described most of the common and 
some of the not-so-common reasons that Econet errors are 
generated. If you experience errors which are not listed here or 
which do not seem to result from the causes or situations 
described, contact your system supervisor. Never ignore error 
messages. A minor error may be the warning sign for a major 
system failure. For more information about the handling of 
errors, refer to the BBC Microcomputer User Guide and the 
relevant filing system manuals. 
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REFERENCE 

SECTION 


This chapter provides a quick reference description of MOS, NFS 
and file server commands. It also describes the file server and 
DFS utilities. The latter are included since many workstations 
are fitted with a disk filing system. It is probable that file server 
resident versions of these programs will become commonly 
available. Also, future versions of the NFS may incorporate them 
in its ROM. 

This section begins with a description of the parameters which 
follow the commands. Most commands follow one of two basic 
formats: 

*command directory specification 
or 

*command file specification 

Those commands and utilities which do not follow these formats 
are simple to learn. 


KEY TO ECONET COMMAND PARAMETERS 

CSD Currently Selected Directory 

If a directory name is not specified when referring to files, the 
filing system assumes that the file is stored in the CSD. 
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CSFS Currently Selected Filing System 

In addition to the CFS and RFS which are found in every BBC 
Microcomputer, there are other filing systems such as the NFS 
and DFS. Only one filing system may be selected at a time. It is 
called the Currently Selected Filing System. If a computer had 
both the DFS and the NFS fitted (resident), commands such as 
*CAT and LOAD "program” refer to the CSFS. This is set by 
commands such as *TAPE, *ROM, *NET and *DISC. 


CSL Currently Selected Library 

Programs written in machine code (assembly language) may be 
stored in the CSD and called as if they were star commands. For 
example, a machine code program stored in a file called 'FRED’ 
could be loaded and run by typing: 

>*FRED 

If the program is not found in the CSD, the filing system looks in 
a special directory called the library. This directory holds 
machine code programs which are of interest to many users. 
Therefore, to save having copies stored in each user’s directory, it 
is saved only once in the CSL with public read access (which is 
usually RL/R). 


DIR Directory Name 

A directory is an area of a disk where information is stored which 
tells the filing system about associated files. The information 
(called a file entry) includes: 

• The file name 

• Its access string 

• Where to load the file into memory 

• Its execution address 

• The length of the file 

• The date when last saved 

• WTiere it is located on the disk 
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The file server will also allow directories to be pointed to from 
within other directories. These are called directory entries. This 
second feature allows us to organize disks in a hierarchical (or 
tree) structure. 


DSC Disk Name 

The name of the disk on which the specified file or directory is 
located may be included in any file or directory specification. It is 
identified by a : which precedes the disk name. For example; 

SYSTEM.$.MARY 

refers to URD MARY on the disk named 'SYSTEM’. Note that the 
$ is optional when the disk name is included in the reference, that 
is: 


*LOAD :CHEM.$.FREDDY.haber = 

*LOAD ;CHEM.FREDDY.haber 

The exception to this is when the root directory is the subject of 
the command. For example, *CAT ;commerce.$ displays the 
contents of the root directory on the disk named 'commerce’. 


DSP Directory Specification 

One or more directory names may be included in a file or 
directory specification. Where a series of names define the 
directory segment of the pathname (file specification), they are 
described as: 

(:DSC.) ($.) (DIR1.DIR2.DIRn) 

For example, a typical directory name taking the form: 
$.FRED.MATHS 

refers to subdirectory 'MATHS’ in the URD 'FRED’. If no DSP is 
included in a command, the CSD is assumed. 
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FLE Filename 

A program or a group of data items may be stored on a disk as a 
contiguous block. This section of the storage media is called a file. 
A name is given to the information when it is first stored and all 
subsequent references are made to the same name. Since the 
name is stored in the directory, along with its SIN, all that the 
filing system needs to find the file again is its filename. 


FSP File Specification 

A file specification is a general description of a file. As a 
minimum, it must include a filename in the CSD or CSL. 
However it may also include a DSP; for example: 

:wordproc.$.joe.text 

refers to file 'text’ in URD 'joe’, stored on the disk 'wordproc’. Note 
that the following are also valid file specifications: 

text 

joe.text 

$.joe.text 

The formal description of an FSP is: 

(:DSC.$.DIR1.DIRn.) [FLE] 

The file specification may also be called the pathname as it 
indicates the 'path’ down the directory tree to a file. 


SIN System Internal Name 

Data is stored on disk drives in parallel circular (concentric) 
tracks. These tracks are divided into equal parts, called sectors. 
These sectors are numbered, starting from 0, 1, 2, 3, ... etc. The 
filing system stores the number of the first sector of each file and 
subdirectory in the directory. This number is called the System 
Internal Name. The filing system uses the SIN to locate files and 
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directories on the disk; for example, a file with a SIN = 77 starts 
on track 7 sector 7 of an Acorn file server disk (formatted with ten 
sectors per track). Note that the first track number is zero. Note 
also that the filing system displays the SIN in the hexadecimal 
rather than the decimal number system. In the example above, 
the SIN would be displayed as '4D’ (hexadecimal) when using the 
*INFO and *EX commands. 


URD User Root Directory 

A user logging-on to the system must enter a valid user identifier 
(USERID) and password. The file server searches for a match in 
the password file then searches the root directory for a directory 
entry which is the same as the USERID. This directory is called 
the User Root Directory. It is the highest directory on the tree 
that a user may own. At log-on, pointers (channel numbers) to the 
URD, CSD and CSL are stored in the workstation. The CSD and 
CSL may be changed as often as the user wishes, however the 
URD can only be changed by logging-on with a different USERID 
or by selecting another disk (refer to *SDISC). 


$ Root Directory 

The highest point on the directory tree (called the root directory) 
is immediately above the user root directories. Its function is to 
provide information about where each URD is stored on the disk 
and to hold the password information. It may not be owned by a 
user although you may have public access. This occurs automati¬ 
cally at log-on if there is no URD in the file server which matches 
the USERID. The root directory is always given the name $. It 
may be accessed in the same way as other directories. For 
example '*CAT $’ displays a listing of the root directory entries. 
Also, '*DIR $’ selects the root directory as the CSD. 


[ ] Mandatory Field 

The field surrounded by these brackets MUST be included in the 
command. 


NBM-I 
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() Optional Field 

Fields surrounded by these brackets are optional. There is a 
general rule when deciding how many fields must be included in 
the command. You must provide sufficient data to ensure that the 
file or directory specification is not ambiguous. For example, if 
the object is in the CSD, the file or directory name is all that is 
needed. If the object is in a subdirectory of the CSD, the 
specification must start from the entry in the CSD which leads to 
it. If the object is in a directory which is not directly linked to the 
CSD, the specification must start with the root directory ($). 
Finally, if the object is on another disk, the disk name must be 
included in the specification. 


Disk Field Name Identifier 

When including a disk name in a file or directory specification, it 
must be preceded by a colon. 


Field Separator 

When a file or directory specification consists of more than one 
field, all fields in the pathname are separated by full stops. 


* String Wildcard 

The inclusion of this character in a file or directory specification 
allows an entry which contains any string to satisfy the 
specification (a wildcard). For a description of wildcards, refer to 
Chapter 4. 


# Single Wildcard Character 

The inclusion of this character in a file or directory specification 
allows an entry which contains any single character in the 
specified character position to satisfy the specification (a wild¬ 
card). For a description of wildcards, refer to Chapter 4. 
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File and Directory Names 

File and directory names must satisfy the following require¬ 
ments; 

• They may be up to 10 characters long. 

• No spaces may be included in the names. 

• They may use the following characters. 

ABCDEFGHIJKLMNOPQRSTUVWXYZ 

abcdefghijklmnopqrstuvwxyz 

1234567890 

!%& = _-I \ @{[' _+;}]<>?/ 

In earlier (Eurocard) versions of the file server, only the following 
punctuation characters may be used: 

! and - 

Note: The operating system ignores the case of characters in file 
and directory names. Care must be taken to avoid creating two 
files with the same name but different case as the second would 
overwrite the first. For example, the following commands are the 
same: 

*load fred = *LOAD FRED = *Load Fred = *10AD fRED 
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^ACCESS 


Syntax 

*ACCESS [FSP] ((L) (W) (R) (/(W) (R))) 
and 

*ACCESS [DSPKD 


Purpose 

To change the access string of files and directories. 


Description 

The access string is a group of characters, stored in each file and 
directory entry. It indicates which operations may be carried out 
by owners and non-owners of the file or directory. 


Directory Access 

This command is used to unlock a directory which is to be deleted. 
To unlock subdirectory $.FRED.MATHS, user FRED would log¬ 
on and then type: 

>*ACCESS MATHS 
> 

Note that the letter D, which is displayed in the access string 
(using the *CAT command), is not included. The character 
indicates that the name refers to a directory rather than a file. If 
unlocked in error, the directory may be relocked by typing: 

>*ACCESS MATHS L 
> 

Note also that there is no public access field with directory 
entries since all entries are always locked to non-owners. 
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File Access 

The file access string is divided into two parts. The first field 
describes owner access. This is followed by the non-owner (or 
public) access field, separated from the first half by a / character. 
The access parameters include: 

L Indicates a locked a file. A locked file cannot be deleted, 
copied to, or have a program or data saved in it. A file is 
locked from the owner when an L is displayed in the access 
string. All files are locked from non-owners. Since this cannot 
be changed, no L character is displayed in the public field of 
the access string. 

R Displays Read Access. This parameter indicates that a file 
may be read in whole or in part into a station’s memory. Some 
operating system and Basic commands affected by this 
parameter include: 

LOAD *LOAD *EXEC INPUT# and BGET# 

W Displays Write Access. This parameter indicates that a file 
may be written to, using the random access file commands. 
Some operating system and Basic commands affected by this 
parameter include: 

SAVE *SAVE PRINT# and BPUT# 

All files are created with the access string WR/. To give the 
maximum access possible to both owners and non-owners of the 
file TDATA, the command is: 

>*ACCESS TDATA WR/WR 
> 

Here, the owner has full access to the file. Non-owners have full 
read and write access. 

To restrict all access to this same file, the command is: 

>*ACCESS TDATA L/ 

> 



In this example, the file cannot be deleted, copied, read from or 
written to by the owners or non-owners. 

Access Required 

This command may only be executed by the owner of the 
directory in which the file or directory entry is resident. 

Type 


File server command. 
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*BUILD 


Syntax 

*BUILD [FSP] 

Purpose 

To create simple text files from the keyboard. 

Description 

The station must have a DFS fitted or there must be a machine 
code program in the CSD or CSL with the name BUILD. On 
entering the command, the file server checks for the existence of 
the specified FSP. The user must have read/write access to the 
file if it already exists, and it must not be locked. If the file does 
not exist, the user must have owner access. The program enters 
the text one line at a time and accepts the machine’s screen 
editing facilities. Each line of text is numbered on the screen. To 
end the text entry, press the ESCAPE key on the line following 
the last line of text. A common use for this command is to build 
!BOOT files (see also *EXEC, *LIST, *TYPE and *OPT 4,3). For 
example: 

>*BUILD !BOOT 
0001 *TV 0,1 
0002 MODE 3 
0003 *WORD 
0004 [Press ESCAPE] 

> 

Note that the line numbers are not stored with the text in the file. 
If these utilities are stored in the file server, they would normally 
be located in $.LIBRARY with the access string RL/R. Future 
versions of the NFS may include this command in the ROM. 


Access Required 

This utility requires a station with the DFS fitted or read access 
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to a BUILD utility, stored in the file server. In either case, the file 
being built must be in a directory which is owned by the user. 


Type 

DFS or file server utility. 
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*BYE 


Syntax 

*BYE 


Purpose 

To sever the link between the workstation and the file server 
(log-off). 


Description 

This command is entered by the user at the completion of a 
session which involved using the file server. 

>*BYE 

> 

The command closes all open files as well as clearing the URD, 
CSD and CSL. If users fail to enter this command, they run the 
risk of having other users obtaining access to their files. 

Note that a user logged-on with one USERID and wishing to 
change to another does not need to use *BYE since the action of 
the *I AM command logs-off the previous owner. Do not 
terminate the session by simply turning off the power at the 
workstation. This erases the station entry; however it does not 
clear the information from the file server. While it does not 
present a risk to the security of your files, it could result in the 
'Too many users’ error being returned when other stations log-on. 


Access Required 

Not applicable. 


Type 


NFS command. 
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*CAT 


Syntax 

*CAT (DSP) 


Purpose 

To display a catalog listing of a directory. 


Description 

This command displays information about the specified directory. 

It includes: 

DSC This is set by the system manager when a disk 

is created. It is specified in the *SDISC com¬ 
mand when selecting a different disk. 

DIR The name of the directory being displayed. 

Cycle number This number indicates the number of times 
that a directory has been written to. It gives an 
indication of the age and usage of a disk. 

CSD The Currently Selected Directory. 

CSL The Currently Selected Library. 

Boot option This indicates how the NFS will handle a 
!BOOT file in the URD if it finds one during 
log-on. 

Ownership This field indicates whether the relevant part 

of the access string is the owner or non-owner 
field in each file entry. 


File entries 


Pointers to files in a directory. 



129 


Directory Pointers to subdirectories in a directory. The 

entries use of directory entries is the feature which 

permits the hierarchical directory structure of 
the Level 2 file server. 

Access string There is an access string associated with each 
file and directory entry (refer to *ACCESS). 

If no directory name is specified in the *CAT command, the CSD 
is assumed. 


The following is an example of this command: 
>*CAT :DISC_TWO.FRED.MATHS 



Cycle 

DIR.^^ 

number 

DSC^^ 

MATHS ^(12) 


DISC—TWO 

CSD- 

-Dir. MARY 


Ownership 


Boot option 

Public 
Option 3 (Exec) 

Lib. LIBRARY 

—-CSL 


Directory 

entries 

File - 

entries 


r Assembler 
1 BASIC 
' Gaussian 
■ SIMPSON 
. 1-data 


DL/ 

DL/ 

LR/ 

LR/R 

LWRAVR 


Owner access 



Public access 


string 


string 


Access Required 

Nil. A user may catalog any directory. 


Type 


MOS command. 
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*CDIR 


Syntax 

*CDIR [DIR] 


Purpose 

To create subdirectories. 


Description 

This command allows the owner of a directory to subdivide his or 
her files into more manageable groups than would be possible 
with a single directory. The directory entry is created in the CSD. 
To create subdirectory LOGO in the URD KATHERINE, log-on 
as KATHERINE and then type: 

>*CDIR LOGO 
> 

If this command is entered in error, the newly created subdirec¬ 
tory must be unlocked before it can be deleted. (Refer to the 
* ACCESS and *DELETE commands.) 


Access Required 

Ownership of the directory in which the directory entry is to be 
created. 


Type 


File server command. 
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♦DELETE 


Syntax 

*DELETE [ESP] 
or 

^DELETE [DSP] 


Purpose 

To delete files and directories. 


Description 

This command allows owners to delete their own files and 
directories. To do so, the file or directory must first be unlocked. 
(Refer to the *ACCESS command.) To delete the file entry 
'CATandMSE’ in the CSD, the owner would t 5 ^e: 

>*DELETE CATandMSE 
> 

As well as being unlocked, a directory to be deleted must not 
contain any file or directory entries. That is, the directory must 
be empty. To delete directory LOGO from the CSD, type: 

>*ACCESS LOGO 
>*DELETE LOGO 
> 

A directory need not be an entry in the CSD to be deleted. The 
only requirement is that you own the specified directory. To 
delete the directory SOURCE from JACK.COBOL where the 
CSD and URD are JACK (i.e. $.JACK.COBOL.SOURCE), type: 

>*ACCESS COBOL.SOURCE 
>*DELETE COBOL.SOURCE 
> 



The file or directory must not be in use by any user as this causes 
the 'Already open’ error message to be returned. 

Access Required 

Owner access to the directory containing the file or directory 
entry to be deleted. 

Type 


MOS command. 
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*DIR 


Syntax 

*DIR (DSP) 


Purpose 

To change the Currently Selected Directory (CSD). 


Description 

At log-on, the CSD is the same as the URD. It may be changed to 
any directory on any disk on the file server. To select subdirectory 
COBOL which is an entry in the CSD, type: 

>*DIR COBOL 
> 

To select a directory owned by another user on the same disk, you 
must include the full directory specification, starting from the 
root directory, for example, *DIR $.FRED.MATHS. To select the 
root directory, type: 

>*DIR $ 

> 

To select a directory on a different disk, the disk name must be 
included, preceded by a colon. The root name is optional. In the 
following example, both commands have the same effect: 

>*DIR :DISC_TWO.$.FRED.MATHS 

or 


>*DIR :DISC_TWO.FRED.MATHS 
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To return to the URD type: 
>*DIR 


Note: Do not include the DSP when returning to the URD as this 
will set the access level for the USD to PUBLIC. 


Access Required 

Nil. A user may select any directory as the CSD. The selected 
directory may have owner or public access, depending on its 
position with respect to the URD. Only directory entries in or 
below the URD are owned by the owner of that URD. 


Type 


File server command. 
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*DISCS 

Syntax 

*DISCS 

Purpose 

To display the names of the disks on the currently selected file 
server. 


Description 

This utility is normally stored in the directory $.LIBRARY with 
its access string set to RL/R. To call the program, type: 

>*DISCS 

drive disc name 
0 SYSTEM_DISC 

1 DISC_TWO 

> 

The user may include the disk name in all file and directory 
specifications by preceding the disk name with a colon, for 
example: 

>*CAT :DISC_TWO.$ 

On some systems this command may be replaced by the *FREE 
utility. 

Access Required 

The user must have read access to the file containing the utility 
program. 

Type 

File server utility. 


NBM-J 
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*DUMP 


Syntax 

*DUMP [FSP] 


Purpose 

To display b 5 d;e-by-byte, the contents of a file in hexadecimal 
notation. Where the bytes represent printable characters, their 
ASCII format is also displayed. 


Description 

To help determine the position of bytes in the file, the first 
column in each row contains a byte count. The second field 
displays the contents of eight bytes in hexadecimal notation. The 
third field displays the eight bytes as text. Bytes which cannot be 
printed in the text field are represented by a full stop. The station 
must have a DFS fitted or there must be a machine code program 
in the CSD or CSL with the filename DUMP. If the hexadecimal 
field displays double asterisks (**) in the last line of the dump, 
they represent bytes past the end of the file. To DUMP the file 
created by the *BUILD utility in this chapter, t 3 T)e: 

>*DUMP !BOOT 

0000 2A 54 56 30 2C 31 OD 4D *TV0 , 1 . M 

0008 4F 44 45 20 30 OD 2A 57 ODE 3 . *W 

0010 4F 52 44 OD ****** ** ORD. 

> 

For large files, it is a good idea to select page mode. [CTRL] [N] 
turns paging on and [CTRL] [0] turns it off Hold the shift key 
down to make the screen scroll. 


Access Required 

This utility requires a station with the DFS fitted or a DUMP 
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utility stored in the file server with read access to the user. In 
either case, the user must have read access to the file being 


DUMPed. 


Type 

DFS or file server utility. 



Syntax 


*EX (FSP) 


Purpose 

To display the information stored in a directory about its file and 
directory entries. 


Description 

This utility uses the *INFO command to display the directory 
information for all entries. The directory header follows the same 
format as the *CAT command. To display a listing of URD 
DIANE, t5rpe: 


>*EX 


DIANE (24) 


WORK_DISC 


Dir. DIANE 


GAMEl 

RL/R 

001384 

28:2:83 

g-data 

RL/R 

000300 

28:2:83 

MATHS 

LR/ 

000487 

13:6:83 

WORDPROC 

DL/ 

000200 

11:1:83 


Owner 

Option 0 (Off) 
Lib. LIBRARY 

FFFF1900 FFFF801F 
0000B9 

00000000 00000000 
OOOOFA 

FFFF1200 FFFF801F 
0003A7 

00000000 00000000 
000037 


Note that an FSP is not required in this example as the URD and 
CSD are the same (as indicated in the header data). For a full 
description of the fields displayed after the filename, refer to the 
*INFO command in this chapter. 
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Access Required 

Nil. A user may examine any directory. 


Type 

NFS command. 
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*EXEC 


Syntax 

*EXEC [ESP] 


Purpose 

To load text from a file, directly into the keyboard buffer. 


Description 

This command allows commonly used input data to replace 
repetitive keyboard input. This command is equivalent to the 
auto-boot EXEC option (set by *OPT 4,3). EXEC files are 
normally created using the *BUILD utility or a word processor. 
Do not use the PRINT# statement in Basic to create EXEC files 
as this reverses the order of characters. This would be meaning¬ 
less as input data. If the file is to be created using a Basic 
program, the characters must be sent byte-by-b 3 de using the 
BPUT# statement. 

A useful application for this command is for customizing 
programs. For example, a program could be designed with a 
number of menu options. An EXEC file could be created which 
would load and run the program. It could provide the initial data 
to select a menu option and then pass more data to make the 
program run in some predetermined manner. When using an 
EXEC file, no keyboard data can be entered until all of the file 
has been input. Consider the !BOOT file created by the *BUILD 
example in this chapter. The file contained: 

*TV 0,1 
MODE 3 
*WORD 

Using *EXEC !BOOT, this file would be loaded into the keyboard 
buffer. If the computer was in the command mode, the first 
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command would disable the video interlace, associated with 
screen jitter on monitors. The next entry would change the screen 
to the 80 X 25 word processing mode. Finally, the last line 
executes Acornsoft’s View word processor. Never attempt to 
EXEC a file which is not a text file. A Basic program cannot be 
EXECed, however a SPOOLed program can be. A useful method 
of editing Basic programs is to open a SPOOL file, list the 
program, close the SPOOL file and finally edit the text file with a 
word processor. The edited program can then be converted back to 
BBC Basic format using the *EXEC command. 


Access Required 

Read access to the file being EXECed. 


Type 

MOS command. 
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*FREE 


Syntax 

*FREE 


Purpose 

To display the names and the amount of free space available on 
the disks of the currently selected file server. 


Description 

This utility is normally stored in the LIBRARY with its access 
string set to RL/R. To call the program, type: 

>*FREE 

disc name free blocks 

SYSTEM_DISC 0000A9 

DISC_TWO 0002C2 

> 

Each block is 256 bytes long. It is important that the free space is 
checked when working with large data files, if there is a chance 
that disk space could be exceeded. This will save complex error 
recovery. The user may include the displayed disk names in all 
file and directory specifications by preceding the disk name with 
a colon. For example: 

>*CAT :DISC_TWO.$ 

This displays the contents of the root directory of'DISC-TWO’. 



143 


Access Required 

The user must have read access to the file containing the utility 
program. 

Type 

File server utility. 



Syntax 


*FX [m] (,n) 


Purpose 

To call OSBYTE routines in the operating system. 


Description 

This command allows a user to invoke common operating system 
calls which perform tasks such as setting the keyboard auto 
repeat rate. *FX calls referred to in this text include; 


*FX 

0 

Display the MOS version number. 

*FX 

5,n 

Select printer channel. 

*FX 

6,n 

Set printer ignore character. 

*FX 

21,n 

Flush specific buffer. 


where n is some number from 0 to 255. For a detailed description 
of these and other *FX calls, refer to the BBC Microcomputer 
User Guide or the Advanced User Guide. 


Access Required 
Nil. 


Type 


MOS command. 
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*HELP 


Syntax 

*HELP (label) 


Purpose 

To display information about the Machine Operating System 
(MOS) and sideways ROMs such as filing systems and languages. 


Description 

Software designers may include an information block in sideways 
ROM software which can be displayed using the *HELP com¬ 
mand. In a workstation fitted with MOS, BBC Basic, View word 
processor. Disk Filing System and Network Filing System, 
typing the *HELP command could display; 

>*HELP 


DFS 0.90 
DFS 
UTILS 

NFS 3.34 

VIEWA2.1 

Stored 

Cmode 

OS 1.20 
> 

The order that the items are listed will depend upon the order 
which they are fitted in the machine, starting from the right- 
hand side. The revision numbers will change with software 



developments. Note that the Basic ROM is not listed. In this 
example, there is a second level of HELP functions. These are 
DFS, UTILS, Stored and Cmode. For example, to display a list of 
DFS utilities, the command is: 

>*HELP UTILS 

Access Required 

Nil. 

Type 


MOS command. 
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*IAM 


Syntax 

*I AM (station number) [USERID] (:) 
: (PASSWORD) 


or 

*I AM (station number) [USERID] (PASSWORD) 


Purpose 

To identify yourself as a valid user to the file server (log-on). 


Description 

Each user is allocated a user identification (USERID) which is 
recognized by the file server. There is usually a password 
associated with it to prevent other users from illegally gaining 
access to your files. The '*I AM’ command passes the USERID 
and PASSWORD to the file server when logging-on. A station 
number may also be included on systems which have multiple file 
servers. If it is not included, the default file server number (254 
on power-up) is used. 

There are two forms of this command. The first includes the 
ability to hide the PASSWORD at log-on. The line is entered with 
the USERID followed by a space and then a colon (:). The next 
line will display a second colon. The NFS then waits for the 
PASSWORD to be entered. As each character is entered, it is 
accepted by the station though not displayed on the screen. A 
typical log-on would appear as follows; 

>*I AM FRED : 


> 
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The PASSWORD appears after the second colon. To log-on to a 
file server with the station number 253, type: 

>*I AM 253 FRED : 

> 

In NFS versions before 3.40, the blind log-on feature is not 
implemented. If you have an earlier version, you would do well to 
upgrade it. Without the hidden password, the command is 
entered as one line: 

>*I AM FRED QX546 
> 

In this case, the following steps in BBC Basic will give the same 
result: 

>MODE 7 
>VDU 157 

>*I AM FRED QX546 
> 

The last line will not appear on the display as the background 
and foreground colors (for that line only) are the same. 


Access Required 
Nil. 


Type 


NFS command. 
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*INFO 


Syntax 

*INFO [FSP] 

or 

*INFO [DSP] 


Purpose 

To display the information stored in a directory about one of its 
file or directory entries. 


Description 

The information string returned by this command is as follows: 

{filename} (access string} (load address} (execute address} 
(length of file} (date-dd:mm:yy} (system internal name} 

Referring to the entries listed in the *EX command in this 
chapter, to display information about the file GAMEl, t 3 TDe: 

>*INFO :WORK_DISC.DIANE.GAMEl 
GAMEl RL/R FFFF1900 FFFF801F 

001384 28:2:83 0000B9 

The FFFFs preceding the load and execute addresses indicate 
that the file was probably created in a BBC Microcomputer 
without a second processor. The execute address of FFFF801F 
indicates that the file probably contains a Basic program. This 
can be verified by examining the file with the *DUMP utility. A 
file load address of zero is normally a random access data file. All 
directories have a load and execute address of zero since these 



parameters have no meaning. The date indicates when the file 
was last saved. The date is set in the file server each day by the 
system supervisor and is written automatically to the disk. The 
System Internal Name (SIN) is the number of the first sector of 
the file or directory on the disc. 


Access Required 

Nil. A user may examine the entry information for any file or 
directory. 


Type 


NFS command. 
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*LIB 


Syntax 

*LIB [DSP] 


Purpose 

To change the Currently Selected Library (CSL). 


Description 

At log-on, the CSL is set to $.LIBRARY if one exists. Otherwise, 
it is set to the root directory. It may be changed to any directory 
on any disk on the file server. To select directory FRED.library 
when the CSD is FRED, t 3 rpe: 

>*LIB library 
> 

To select a directory belonging to another user on the same disk 
as the library, you must include the full directory specification, 
starting from the root directory; for example: 

*LIB $.JOHN.DRIVERS 

To select the root directory, simply t 3 T)e: 

>*LIB $ 

> 

To select a library on a different disk, the disk name must be 
included, preceded by a colon. The root name is optional. In the 
following example, both commands are acceptable: 

>*LIB :DISC_TWO.$.LIBRARY 
or 

>*LIB :DISC_TWO.LIBRARY 


NBM-K 



Access Required 

Nil. A user may select any directory as the library. However all 
files in a library should have public read access. 


Type 


File server command. 
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»LIST 


Syntax 

*LIST [FSP] 


Purpose 

To display the contents of text files on the screen with each line 
preceded by a line number. 


Description 

This utility is useful for displaying text files which have been 
saved using the *SPOOL and *BUILD commands. To LIST the 
file created by the *BUILD utility in this chapter, t 5 npe; 

>*LIST !BOOT 
0001 *TV 0,1 
0002 MODE 3 
0003 *WORD 
> 

Do not use this command if there are any non-printing characters 
in the file. In general, this is ASCII values less than &20 and 
greater than &7E. The obvious exceptions to this are the carriage 
return (&0D) and line feed (&0A). If you are unsure of the 
contents of the file, check it first with the *DUMP utility. 


Access Required 

The station must have a DFS fitted or there must be a machine 
code program in the CSD or CSL with the filename LIST. In 
either case, the user must have read access to the file being 
LISTed. 


Type 


DFS or file server utility. 
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*LOAD 


Syntax 

*LOAD [FSP] (load address) 


Purpose 

To load a complete file into the random access memory (RAM) of a 
workstation. 


Description 

This command differs from the Basic LOAD statement where the 
file to be loaded must be a valid Basic program. Quotes may be 
included around the filename, though this is optional. If no load 
address is included, the file will load into memory at the load 
address stored in the directory entry. The file parameters can be 
found by executing the *EX or *INFO commands. To load the file 
'Image’ at its default load address, t 5 T)e: 

>*LOAD "Image” 

> 

If a load address is specified in the command, the file loads into 
memory at the specified address, for example: 

>*LOAD fred 2000 
> 

The file 'fred’ would load into memory at &2000. A load address 
which is preceded by FFFF such as FFFF2000 would load into the 
input/output (I/O) processor (the BBC Micro) if there is a second 
processor attached. Addresses below FFFFOOOO such as 2000 
would load into the second processor if attached, otherwise they 
load into the BBC Micro. 
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Access Required 

The user must have read access to the file being loaded. 


Type 

MOS command. 
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^NOTIFY 


Syntax 

*NOTIFY [station number] (") (message) (”) 
or 

^NOTIFY [USERID] (") (message) (”) 


Purpose 

To send a message to another station on the network. 


Description 

This utility allows messages to be sent to any unprotected station 
(refer to the *PROT command) attached to the network. Note that 
the receiving station need not be logged-on to the file server 
unless its address is specified as its USERID. The transmitting 
station would normally be logged-on to the file server since this is 
where the NOTIFY utility is stored. To send a message to station 
number 10, type: 

>*NOTIFY 10 "Hello ten! Please phone office” 

> 

The text following the station number is sent to station number 
10. If it is connected to the network, powered-on and not 
protected, the text is inserted into its keyboard buffer. When text 
is to be read from the keyboard, the message is read. If the 
program being executed flushes the keyboard buffer or does not 
display the text read, the message will not appear on the screen 
so that a retry may be necessary. It is best to use *VIEW before 
and after *NOTIFY. This ensures that important work is not lost 
at the receiving station by interruptions and that the message 
does in fact reach its destination. 
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Stations can be notified by their USERID. The USERID replaces 
the station number. If there is more than one user logged-on with 
the same USERID, only one will receive the message. To send to 
USERID FRED, type: 

>*NOTIFY FRED Hello Fred! Please phone office 

> 

If transmission is successful, the message is displayed at the 
receiving station, preceded by the station number of the sender. If 
the addressee is protected, the error message 'Not listening’ is 
returned. For further information about this command, refer to 
Chapter 6. 


Access Required 

The user must have read access to the NOTIFY utility in the file 
server. 


Type 

File server utility. 
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*OPT 


Syntax 

*OPT [m] (,n) 


Purpose 

To set a variety of control parameters for the MOS and filing 
systems. 


Description 

The application of this command is determined by the first 
parameter (m). 


*OPT 

0 

Reset error handling and message 
options. 

*OPT 

l,n 

Display file information when files are 
loaded. 

*OPT 

2,n 

Set error handling options for cassette 
filing system. 

*OPT 

3,n 

Set interblock gap for cassette filing 
system. 

*OPT 

4,n 

Set auto-start options. 


Note that the first and second parameters must be separated by 
either a comma or space. *OPT 2 and *OPT 3 are used only with 
the cassette filing system. *OPT 1,2 enables the message system 
which displays information about the file (as displayed by the 
*INFO command) each time a file is SAVEd or LOADed. 

The options do not apply to all resident filing systems. Thus, if 
you wished to have the file information displayed for both the 
CFS and NFS, the *OPT command must be executed in each 
filing system selected. 
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The auto-start feature (auto-load or auto-boot) of the BBC 
Microcomputer allows a set sequence of steps to be executed at 
log-on. After checking the PASSWORDS file for a valid USERID 
and PASSWORD, the boot option is read. This determines the 
action taken after selecting the URD. This option is set using the 
*OPT 4 command. The options are as follows: 


COMMAND 

OPTION 

*OPT 4,0 

No action required 

*OPT 4,1 

*LOAD the file !BOOT 

*OPT 4,2 

*RUN the file !BOOT 

*OPT 4,3 

*EXEC the file !BOOT 

If option 1, 2 or 3 

is set, the URD is searched for the file !BOOT 


and is processed as defined by the above list. If the file !BOOT is 
not found, the error 'File not found’ is returned. If option 0 is set, 
the start sequence is completed without searching for !BOOT. 

Note that the boot option only affects the URD at log-on. It cannot 
be used when other directories are selected. For more information 
about the use of this command, refer to Appendix A. 


Access Required 
Nil. 


Type 


MOS command. 
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*PASS 


Syntax 

*PASS (") [old password] (”) (") (new password) (”) 


Purpose 

To change your password entry in the file server. 


Description 

This command allows you to set and change your own password. 
When your USERID is first created, you have no password (i.e. a 
null field or " ”). The first time that you log-on to the system, you 
should set your password. For example, to set the password to 
'qxY98*’, type: 

>*PASS "qxY98*” 

> 

There are times when USERIDs are not given a password. BOOT 
is a good example of this. A password may be removed completely 
by setting the password to " ”. Since it is important to keep your 
password a secret from other users, make sure that there is no 
one looking over your shoulder when you use this command and 
erase the screen immediately after use. The password may be up 
to six characters long and should never be obvious to other users. 
For example, your surname or nickname is not a good choice. If 
you forget your password, contact the system supervisor. 


Access Required 

Nil. 


Type 


File server command. 
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*PROT 


Syntax 

*PROT 


Purpose 

To prevent other users from communicating with your station. 


Description 

This command locks out VIEW, REMOTE and NOTIFY. Your 
system may not have these utilities available. However, if they 
are, it is a good idea to execute the *PROT command before 
starting work if you do not wish to be interrupted. On some 
systems, this command may be executed automatically. 

There are times when you will want to be able to communicate 
with other stations. Protection may be disabled with the 
*UNPROT command. As a general rule, stations should be 
protected if the communications utilities are freely available on 
your system and you do not wish to be VIEWed or interrupted. 


Access Required 

The user must have read access to the PROT utility in the file 
server. 


Type 

File server utility. 
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*PS 


Syntax 

*PS [station number] 


Purpose 

To change the station number of the printer server to which a 
station sends text for printing. 


Description 

On a hard reset (CTRL-BREAK or power-up), the number 235 is 
stored in each station. This represents the printer server station 
number. If your system has multiple printer servers, the default 
printer server number can be changed using this utility. To 
change to printer server number 234, type: 

>*PS 234 
> 


This utility may be called from within programs if necessary 
without causing harm to your programs since it loads into system 
workspace. 


Access Required 

The user must have read access to the PS utility in the file server. 


Type 

File server utility. 
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*REMOTE 


Syntax 

*REMOTE [station number] 
or 

*REMOTE [USERID] 


Purpose 

To take control of another station on the network. 


Description 

This utility allows any unprotected station (refer to the *PROT 
command) connected to the network to be remotely controlled. Its 
keyboard is disabled and control is transferred to the station 
initiating the REMOTE command. Note that the station being 
controlled need not be logged-on to the file server unless the 
address specified in the command is a USERID rather than a 
station number. The transmitting station would normally be 
logged-on to the file server since this is where the REMOTE 
utility is stored. To REMOTE station number 10, type: 

>*REMOTE 10 

> 

After this, all text t3T3ed on the keyboard of the controlling 
station will appear on both screens; that is, it will act as a 
terminal to the other station. The USERID of the destination 
station can replace the station number. To take control of user 
FRED, type: 

>*REMOTE FRED 

> 
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No message is sent to the machine being REMOTEd. The user of 
the controlled machine will only be aware of the operation if he 
attempts to type on the keyboard or when commands are entered 
at the controlling station. If the addressee is protected, the calling 
station will lock-up until the ESCAPE or BREAK key is pressed. 
A REMOTE operation is terminated by execution of the *ROFF 
command at the controlling station. 

Access Required 

The user must have read access to the REMOTE utility in the file 
server. 


Type 


File server utility. 



165 


^RENAME 


Syntax 

^RENAME [old ESP] [new ESP] 


Purpose 

To change the name of a file. 


Description 

This command allows a user to change a file entry from one name 
to another. Eor example: 

>*RENAME ERED JIM 
> 

changes the filename of ERED to JIM in the CSD. A directory 
specification may precede the filename. Eor example: 

>*RENAME :WORK.MAX.ERED :WORK.MAX.JIM 
> 

changes the file entry from ERED to JIM in directory MAX on the 
disk named WORK. Provided the user owns both directories, the 
name change may involve moving the file entry from one 
directory to another. Eor example: 

>*RENAME :WORK.MAX.ERED :WORK.JOHN.ERED 
> 

moves the file ERED from directory MAX to directory JOHN on 
the same disk. 

In this example, there is no change of filename though this could 
have been included. Note that this command does not allow a 
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name change from one disk to another as this involves a transfer 
of the complete file. 

Access Required 

Owner access of the directory or directories affected by the 
command. 

Type 


File server command. 
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*ROFF 


Syntax 

*ROFF 


Purpose 

To terminate REMOTE control of another station. 


Description 

This utility provides an orderly termination at both stations after 
executing the *REMOTE command. If the command is called 
from the keyboard, it will also be seen as input to the station 
being controlled. 

A program running in the controlled station could be adversely 
affected by the execution of this command. For example, if a Basic 
program is started under REMOTE control, the program would 
stop when the *ROFF command was called. This must be allowed 
for when calling programs under REMOTE control. 


Access Required 
Nil. 


Type 

NFS command. 


NBM-L 
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*RUN 


Syntax 

*RUN [FSP] (argument) 
or 

*/ [FSP] (argument) 


Purpose 

To load and run a machine code program. 


Description 

This command is used to call machine code programs. It is 
equivalent to calling these programs as star commands. For 
example, to execute program $.FRED.SERVICE.DUMP when 
the CSD is MARY and the CSL is LIBRARY, type; 

>*RUN $.FRED.SERVICE.DUMP 

or 

*/ $.FRED.SERVICE.DUMP 

Optional parameters may be included after the filename which 
can be passed to the program. 


Access Required 

Read access to the file being *RUN. 


Type 


MOS command. 
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*SAVE 


Syntax 


*SAVE [FSP] 

[load] 

[end] 

(execution) 

(new load) 

or 

*SAVE[FSP] 

[address] 

[address] 

(address) 

(address) 

[load] [+] 

[file] 

(execution) 

(new load) 


[address] 

[length] 

(address) 

(address) 


Purpose 

To store an image copy of a section of a station’s memory in a file. 


Description 

This command copies a contiguous block of memory to the named 
file. If a file exists with the FSP, the file must be unlocked. All 
SAVEd files have their access string set to WR/. In its simplest 
form, only the start and end address (or the start address and file 
length) of the named file need be specified, for example: 

>*SAVE textfile FFFF3A00 FFFF4000 

or 

>*SAVE textfile FFFF3A00 + 600 

Note that all addresses must be specified in hexadecimal 
notation. When a file is loaded into memory using the *LOAD 
command, the file entry determines the load address if none is 
specified in the command. The execution address is the point in a 
program where control is transferred to when *RUN or if called 
as a star command. If the file is a program and no execution 
address is specified, the load address is assumed. In the last 
example, the file entry displayed by the *INFO command would 
look something like this: 
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>*INFO textfile 

textfile FFFF3A00 FFFF3A00 000600 
WR/ 18:9:83 0003D0 

If the file is to be used in a different part of memory from where it 
was saved, the new load address may also be specified. If the file 
is a program, the execution address should reflect the new load 
address. 

>*SAVE PROG FFFF3000 + 300 FFFF1207 FFF- 
F1200 

In this example, the file entry displayed by the *INFO command 
would be: 

>*INFO PROG 

PROG FFFF1200 FFFF1207 000300 

WR/ 18:9:83 000518 

If there is no execution address, some value must still be specified 
if a new load address is to be included. It would normally be set to 
the new load address. Note that the addresses are preceded by 
FFFF. This indicates that the file is to load into the input/output 
processor (the BBC Micro) when a second processor is attached. 


Access Required 

The file being SAVEd must be in a directory which is owned by 
the user. 


Type 


MOS command. 
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*SDISC 


Syntax 

*SDISC [DSC] 


Purpose 

To change the currently selected disk. 


Description 

If no disk name is specified when referring to a file or directory, a 
default disk name is assumed. At log-on, this is the name of the 
disk on which the URD is stored. If a new CSD is selected on 
another disk using the *DIR command, the currently selected 
disk name changes to the new disk. It is also possible to select 
another disk name directly with the *SDISC command. 

If the new disk has a directory specification matching the old 
URD, this will become the new URD. 

For example, if the URD was :System.$.FRED and the new disk 
has a directory :Work.$.FRED, this will become the new URD. If 
there is no matching directory, the root directory will become the 
URD. To find the names of all disks on the file server, use the 
DISCS or FREE utilities in the LIBRARY. 


Access Required 
Nil. 


Type 


File server command. 
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*SPOOL 


Syntax 

*SPOOL [FSP] 


Purpose 

To copy all screen output to the specified file. 


Description 

This command is used to save a copy of text being sent to the 
screen for later processing. It is the opposite of the *EXEC 
command. A common use is for obtaining text file copies of Basic 
programs for editing by a word processor. A Basic program 
cannot be edited directly as it contains characters which would 
cause undesirable effects on the screen. Another use for this 
command is to save a copy of text output from a program for 
review, reporting and perhaps further processing. 

The command is called by typing '*SPOOL filename’ and is 
terminated by typing '*SPOOL’. All text sent to the screen 
between these two commands is also written to the specified file. 

Note that some word processors will not accept files which 
include line feed characters. These must be removed before being 
read by the word processor. The following program performs this 
operation; 

10 lunol = OPENIN "spoolfile” 

20 luno2 = OPENOUT "newfile” 

30 REPEAT 

40 a = BGET# lunol 

50 IF a <> 10 THEN BPUT# luno2, a 

60 UNTIL EOF# lunol 

70 CLOSE# lunol, luno2 
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Access Required 

The file being SPOOLed must be in a directory which is owned by 
the user. 

Type 

MOS command. 
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*TYPE 


Syntax 

*TYPE [FSP] 


Purpose 

To display the contents of text files on the screen. 


Description 

This utility is useful for displaying text files which have been 
created with the *SPOOL and *BUILD commands. To *TYPE the 
file created by the *BUILD utility in this chapter, type: 

>*TYPE !BOOT 
“"TV 0,1 
MODE 3 
*WORD 

> 

Do not use this command if there are any non-printing characters 
in the file. In general, these are ASCII values less than &20 and 
greater than &7E. The obvious exceptions to this are the carriage 
return (&0D) and line feed (&0A). If you are unsure of the 
contents of the file, first check it with the *DUMP utility. 


Access Required 

The station must have a DFS fitted or the user must have read 
access to a machine code program stored in the CSD or CSL with 
the filename TYPE. In either case, the user must have read 
access to the file being *TYPEd. 


Type 


DFS or file server utility. 
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^UNPROT 


Syntax 

*UNPROT 


Purpose 

To disable the protection facility which prevents other users from 
communicating with your station. 


Description 

If communication utilities (VIEW, REMOTE and NOTIFY) are 
available on your system, you may wish to allow others to 
communicate with you. This command reverses the effects of the 
*PROT command. The utility is normally stored in the same 
directory as the communication utilities. This will most likely be 
$.LIBRARY. To execute this command, type: 

>*UNPROT 

> 

Access Required 

The user must have read access to the UNPROT utility in the file 
server. 


Type 


File server utility. 
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*VIEW 


Syntax 

*VIEW [station number] 
or 

*VIEW [USERID] 


Purpose 

To display a copy of another station’s screen on your own station. 


Description 

This utility allows you to transfer a copy of the screen memory of 
an unprotected station into the same area of memory of your own 
station. It is called by t3T)ing: 

>*VIEW X 

where x is either the station number of the machine being 
VIEWed or the USERID of the user logged-on to that station. On 
entering the command, your screen will change after a brief 
pause to display the viewed screen. 

If the station being VIEWed requires more memory than the 
screen mode of your own station, an error is returned with the 
screen mode displayed in the error message. If VIEW is called 
from within a program, the screen mode can be found using an 
OSWORD call. If the station being VIEWed is protected, the 
calling station will lock-up until the ESCAPE or BREAK key is 
pressed. 
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Access Required 

The user must have read access to the VIEW utility in the file 
server. 

Type 

File server utility. 



11 

ECONET TECHNICAL 
DESCRIPTION 


While you may not need to understand the theory of the internal 
combustion engine to drive a car, some information about its 
systems aids your overall performance as a driver; particularly 
when things go wrong! In the same way, an understanding of 
network organization and operation will help you to get the best 
from the Econet. 


NETWORK TOPOLOGY 

A network consists of two or more communicating computers, a 
transmission channel and a common method of sending and 
receiving data which all of the computers can understand (a 
protocol). The method of sending data to the correct station is 
handled in different ways by the various network systems that 
are available. In general, the techniques are: 

• Directed. The organization of the system directs the 
message to the correct station. 

• Broadcast. The receiver must decide whether the mes¬ 
sage is addressed to it or to another station. 

Most networks are linked together in one of three ways: Star, 
Ring or Bus. This is called the network architecture or topology. 
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The first two of these structures are directed while the bus is 
normally a broadcast system. 


Star 

A star network is one in which there is a central controller with 
individual cables connected to each computer; for example, the 
telephone network consists of a number of interconnected stars. 
The center of each star is the local phone exchange, with lines 
radiating to homes and offices. A system called circuit switching 
is employed. At the exchange, a circuit is set up between each 
pair of communicating terminals for the period of the conversa¬ 
tion. 



Figure 11.1 The Star 

There are few computer networks using the star arrangement. Its 
biggest disadvantage is that stations cannot communicate direct¬ 
ly from one to another. Messages must go via the central 
controller (a node). Because of this, star networks are usually 
slower. A variation of the star is the tree. In effect, this is a 
number of star networks where one line from each node is 
connected to higher and lower nodes. 

The tree (or hierarchical) network tends to be more complex than 
the star but it allows for more expansion. 
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Ring 

In this system, the computers are linked by a ring of cable. 
Messages must pass through each station. One advantage of the 
ring is that the message travels in one direction only. Faults can 
be quickly isolated as the signal travels directly from one station 
to the next. 

Messages on the ring are configured as packets of data. Each 
packet begins with a header block which contains the addresses 
of the sending and receiving stations. The packet also contains 
data indicating if it has been received, if it is empty, and if it 
managed to reach its destination. The Cambridge Ring is a good 
example of this type of system. 



Bus 

In the bus network, one cable connects all machines in parallel. 
Since only one message at a time can pass along the bus, the 
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machines sharing the cable must co-operate. With mass produc¬ 
tion, the complex circuitry needed to control this is now quite 
inexpensive. This electronics is called the network interface. The 
program which controls communications is called the Network 
Filing System (NFS). 

Before transmission, the station must ensure that the bus is 
clear, since only one may transmit at a time. Even after checking 
that the bus is available, it is possible that two or more stations 
could start transmitting at the same time (a collision). Each 
station must be able to detect these collisions. The network 
interface includes a collision detect circuit. Also, the NFS 
contains a 'collision arbitration algorithm’. After a collision, each 
station waits for a different length of time before retrying. The 
system must also check that transmitted data is not received 
corrupted. The system must be able to retransmit packets that 
have been corrupted. 

Physically, the bus system is a simpler layout than the other 
structures described. Stations are connected to the main trunk 
cable by connecting leads (which should be kept as short as 
possible). Long T junctions are not permitted. The network must 
be correctly terminated at each end to prevent standing waves 
and noise from corrupting the signal. Of the systems described, 
only the bus architecture uses a broadcast system. There are 
many other arrangements such as the mesh (or matrix) where 
each node has several paths to other nodes. Such systems are 
complex and expensive. They are usually in systems where ultra- 
high reliability is needed. 


THE ECONET SYSTEM 

The Econet is a bus network using cable transmission over two 
pairs of wire which connect all stations together. Information 
travels in a serial bit form over one pair of wires and the other 
pair carries the network synchronization signal or 'clock’. The 
Econet provides fast access between stations. It continues to 
operate if other stations are not working. The bus approach 
allows stations to communicate without involving a third party 
and the interface hardware is simple. It operates at relatively 
high speed and the total length of cable required is minimized. 
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A balanced line system is used. This means that the two wires of 
each pair always carry opposite voltages. When the signal goes 
positive on one, it goes equally negative on the other. The signal 
is detected by a differential receiver — one that operates only on 
the potential difference between the pair of wires. 

This provides two benefits: 

• In each twisted pair, the RF radiation from one wire 
cancels out the other. Radiated signals which could 
interfere with other electrical equipment are negligible. 

• External interference (for example, inductive pick-up) is 
likely to affect both wires equally so will be ignored by 
the system. 



ECONET INTERFACE CIRCUIT DESCRIPTION 

The Econet circuit design has been essentially the same in all of 
the Acorn computers. It is based on the MC68B54 Advanced Data 
Link Controller (ADLC) integrated circuit. Other components in 
the interface include the line driver and receivers, network 
collision detector and station identifier. 


NBM-M 
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Address Decoding 

In the BBC Microcomputer, all input/output devices (except the 
1-MHz bus) reside within one page (256 locations) of memory, 
starting at &FE00. Page &FE is named 'Sheila’. There are three 
address select lines decoded for the Econet; ADLC, INTON and 
INTOFF/STATID. The ADLC line selects the 68B54 device. It is 
further decoded internally, using AO, A1 and the R/W lines to 
select registers within the device. The destination of ADLC write 
operations are also determined by bit one of control register one 
(clbl). The INTON line enables the non-maskable interrupt 
(NMI) input from the the ADLC. INTOFF/STATID enables the 
station address buffer. It also disconnects the NMI line to disable 
unwanted interrupts. The Econet addresses are as listed in Table 
11 . 1 . 


Station Identification 

The identification number of each station is set up in hardware 
using jumper links. IC 96 is an octal buffer which passes the 
station ID to the processor. Each link represents a bit in an eight- 
bit binary number allowing any station ID in the range zero to 
255 to be set up. If a link is left open then the bit is a one. When a 
link is made the bit is a zero. Hence all-links-open corresponds to 
station number 255, and all-links-made represents station num¬ 
ber 0. Each station must have a unique identity and some 
identities are associated with specific functions on the network. 
Station numbers 0 and 255 are reserved for broadcast messages 
and should not be used. Number 254 is reserved for the file 
server, and 235 for the printer server. A suggested scheme for 
number allocation is to number normal user stations from one 
upwards and to number special stations and servers from 254 
downwards. 


MC68B54ADLC 

The Motorola (or equivalent) 68B54 Advanced Data Link Con¬ 
troller (IC 89) is the link between the computer and the network. 
It is a single 28-pin nMOS device. It is connected on one side to 
the main address, data and control lines of the processor, and on 
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Table 11.1 Econet Addresses 


R/W 

0 


1 

&FE18 

INTOFF/STATID 


INTOFF/STATID 

&FE20 

VIDPROC 


INTON 


clbl 


&FEA0 

WRCl 

X 

RSRl 

&FEA1 

WCR2 

0 

RSR2 


WCR3 

1 


&FEA2 

Tx FIFO 
(frame continue) 

X 

Rx FIFO 

&FEA3 

Tx FIFO 

0 

Rx FIFO 


(frame terminate) 
WCR4 

1 



the other to the Econet line driver and receivers. It contains the 
following registers: 

• Four write-only Control Registers determine what the 
chip does. Two read-only registers report the status of the 
chip to the CPU. For example, a value sixteen read from 
Status Register 2 means 'Clear-to-send’; the value one 
read from Status Register 2 means 'Address present’. 

• Three Receive Registers are arranged in a first-in first- 
out sequence (FIFO) so that received data is buffered for a 
short time while the ADLC and the processor work out 
what to do with it. These are read-only and occupy, in 
turn, one address (&FEA2 or &FEA3). 

• Three Transmit Registers are also arranged as a FIFO 
group. There are two write addresses for them so that the 
programmer can distinguish between a 'frame continue’ 
and a 'frame terminate’ byte. 
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- LOOP ON LINE CONTROL/DTR 

- RTS 


Figure 11.6 ADLC block diagram 


The ADLC is a complex device with a number of functions: 

• It monitors the communications lines and interrupts the 
CPU when a message is detected. The CPU must then 
decide if the message is addressed to it. It does this by 
comparing the received address with its own (STATID). 

• It checks the validity and correctness of messages 
received, informing the CPU of any faults. Validity 
means message packets must have the correct structure; 
correctness is determined by the CRC as explained below. 
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• It converts the bit-serial data that it receives into bit- 
parallel bytes for the CPU, and vice-versa on transmis¬ 
sion. 

• It adds header and trailer information to the data from 
the CPU on transmission to make up a packet or 'frame’. 
It removes this packaging on reception. 


The Econet Packet 

All information on the Econet is sent in packets or frames. The 
frames are assembled and dismantled by the ADLC chip. 


Opening 

Flag 

Address 

To 

Address 

From 

Port 

No. 

...Data Block 

CRC 

Closing 

Flag 

01111110 







□ 

□ 

01111110 


Figure 11.7 Format of an Econet packet 


A frame consists of: 

• An eight-bit opening flag, which is always 01111110 
(&7E). 

• A two-byte address field, allowing for more than 65000 
stations to be addressed. Only one b 5 d;e of this is used in 
the current Econet address (up to 254 stations). The other 
byte is reserved for addressing other networks via 
Gateways. 

• Another two-byte address, which is the address of the 
sending computer. 

• A single-byte 'port number’ which tells the receiving 
station what type of message is in the packet. 

• An information field of any length. With the Econet clock 
set for a transmission speed of 240K baud, a 64K block 
would monopolize the network for just over two seconds 
(240K baud is 30K bytes per second). Viewing a 20K 
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high-resolution screen, or transferring a 20K program 
from one machine to another, would take less than a 
second. 

• Frame Check Sequence (FCS). This is a two-byte Cyclic 
Redundancy Check number (the CRC). As the ADLC is 
sending out characters (including address and control 
bytes, such as the port number) the FCS Generator is 
calculating a weighted sumcheck known as the CRC, 
using the polynomial 

4" X^ 4" 1 

The complement of the remainder (the CRC) is sent at the 
end of the packet. On reception the FCS is recalculated 
and compared to the received CRC. The results should 
always be &F0B8, if there has been no data corruption. 

• A closing flag, which is also 01111110. Until this is 
received the ADLC does not know the length of the frame. 
Since there are three Receive Registers, the two CRC 
bytes will still be held in the ADLC when the closing flag 
is detected. They can, therefore, be checked and the 
'Frame Valid’ (bit 1) or 'CRC error’ (bit 4) bits set in 
Status Register 2. End of frame is indicated by the setting 
of bit 6 in Status Register 1. 

The opening and closing flags are immediately detectable by the 
ADLC because such a pattern cannot occur in the data. This is 
because all ADLC transmitters automatically insert a zero after 
any occurrence of five consecutive ones an 3 rwhere within a frame. 
All ADLC receivers delete any zero that follows five consecutive 
ones. So six consecutive ones followed by a zero can only be an 
opening or closing flag. Seven or more consecutive ones indicate 
an aborted frame; 15 or more ones indicate a free bus. The 
termination of the network pulls undriven data lines into the 
'one’ condition. 


Resetting the ADLC 

On reset, the NFS will be selected if it is the right-most filing 



189 


system ROM or if the 'N’ key is depressed. The system reset 
signal (RST) is taken to the ADLC. This clears internal registers 
and sets the output lines to a known state. As part of the reset 
process, the NFS disables the NMI interrupt line from the ADLC 
at the same time as it reads the station number (INTOFF/ 
STATID). (The number is displayed on the screen at reset.) The 
ADLC registers are initialized for normal operation. Finally, the 
ADLC interrupt line is reconnected by reading address &FE20 
(INTON). Applications programs can disable Econet interrupts 
by reading address &FE18; however the recommended approach 
is to use the 'claim NMF protocol, as described in the Advanced 
User Guide. 


Transmitters 

The transmission of data and clock onto the network is via a 
75159 dual differential line driver (IC 93). This device conforms 
to the EIA RS-422 specification and can source or sink 40 mA. 
Differential line techniques ensure both minimal radiation and 
high noise immunity for the network. Prior to Issue 4 circuit 
boards, BBC Microcomputers could be fitted with the Econet 
clock circuitry on board. The general approach now is to supply 
the clock from an external source. In this description, external 
clock generation is assumed. The data driver is enabled by a 
'Rquest to send’ signal from the ADLC when it wishes to 
transmit. When disabled or powered-down, the buffers have high 
impedence outputs and so stations may be left connected to the 
network even when they are not in use. 


Receivers 

When a transmission is received, the ADLC sends an interrupt to 
the NMI input of the microprocessor, via an inverter (IC 91) and 
an open collector gate (IC 27). The other input to the gate is from 
a D flip flop (IC 97). The D and Preset input lines of IC 97 are 
normally high. If the D input goes low (INTON), Q goes high 
which enables Econet interrupts. If the Preset input goes low 
(INTOFF/STATID), Q goes low which disables Econet interrupts. 
The sequence begins with the interrupts enabled. On receipt of an 
NMI request, the interrupt service routine is entered which 
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starts by reading the station number (STATID). This also 
disables further interrupt requests from the ADLC until the first 
request is serviced. 

The reception of data and clock signals from the network is 
accomplished using an LM 319 dual fast differential comparator. 
The receiver circuits are designed to give high common mode 
signal rejection and hysteresis, thus providing excellent noise 
immunity. The network clock is received to synchronize the 
ADLCs in all stations for both reception and transmission of data. 

When no station is driving the network the ADLC needs to be 
able to reliably detect that the network is undriven and therefore 
free for use; to this end undriven data lines must appear as a 
continuous stream of logic ones and not random noise which could 
be taken for some other station’s data. The network terminators 
bias the lines so that the input to the receivers is a logic one in the 
absence of a logic zero being transmitted onto the network. As 
mentioned earlier, ADLCs use a technique called Zero Bit 
Insertion. When they are transmitting, a logic zero is seen every 
few bits. 

As a consequence of the biased receivers and the zero-bit 
insertion technique, a station coming onto the network and 
wishing to transmit, monitors the data line and knows that the 
network is free if it receives 15 consecutive logic ones. 


Collision Detection 

One characteristic of broadcast networks is that collisions can 
occur if two stations transmit at the same time. This is largely 
avoided by testing that no other station is driving the network 
before commencing transmission. However there is a period of 
time between a station detecting an undriven network and then 
enabling its driver to start transmission. During this period 
another station may begin to transmit and a collision will occur. 
The SN75159 driver circuit is not damaged in this event but the 
data on the network is corrupt. Every station has a collision 
detector circuit which informs its ADLC that a collision has 
occurred. The stations abort their attempt to transmit and wait 
for different periods of time before trying again. 
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The collision detection circuit is based on an LM319 dual 
comparator (IC 95) which is used to compare the data signal lines 
with the common mode signal on the line. When stations collide, 
their differential drivers will short out and the data lines will be 
forced to the same voltage. If one or the other of the two data lines 
is above the common mode signal by more than one volt, the data 
is assumed valid. However, if they both drop below the common 
mode voltage, a collision has occurred. The comparators have 
open collector outputs. The two used in the collision detect circuit 
have their outputs arranged in a 'wired or’ configuration, giving 
the 'Data valid’ signal when there are no collisions. 


Clock Valid Monostable 

The ADLC should only attempt to transmit when the data lines 
are free and there is a valid clock to synchronize the data 
transmission. The valid clock condition is sensed using a 
retriggerable monostable which only produces a 'Data carrier 
detect’ signal when the station is connected to a clocked network. 
'Data valid’ and 'Data carrier detect’ are ANDed together to give 
a 'Clear to send’ signal for the ADLC. The ADLC can differentiate 
between the unconnected network and the data not valid 
conditions as a 'Data carrier detect’ signal is also fed to it from the 
monostable. 


Network Termination 

As noted previously, the network must be correctly terminated. 
The termination serves two purposes, to prevent reflections and 
to bias the data lines. 

The signals traveling along the wires will be reflected from the 
ends and then interfere with the forward direction signals if the 
ends are not correctly terminated. To prevent reflections, the 
impedance across the end of the wire should be the same as the 
wire itself. The cable used for the Econet system has an 
impedance of about 100 ohms. The terminators should therefore 
present 100 ohms across the lines. 

The data lines should also be biased so that in the absence of any 
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signals, the data line is in such a state that it will be interpreted 
as a logic one by the receivers. Some terminators provide this bias 
through their own power supply (Active Termination). Others 
obtain their power from the line itself (Passive Termination). 
There are merits for each technique. Whichever is used, the 
signals must be correctly biased and noise-free. 


Network Clock 

The Econet system needs a clock signal for timing purposes. As 
with the data, this is provided on a differential pair of clock lines. 
The clock signal is injected into the network by a clock generator. 
This produces a stream of regular square waves of constant 
frequency. If the clock signal is too slow or too fast or is corrupted 
in some way, the 'No clock’ error message is returned on reset and 
whenever transmission is attempted. 


♦sv 



Figure 11.8 Econet circuit diagram 





APPENDIX A 
THE AUTO-START 
FACILITY 


As part of the log-on process, the user may preset some sequence 
of steps to be executed. When logging-on, the option field is 
checked in the PASSWORDS file. This parameter is set using the 
*OPT 4,n command where n is a number with the value 0,1, 2 or 
3. It is displayed in the header data of a catalog listing. If its 
value is not zero, a file with the name 'IBOOT’ is searched for in 
the URD. If the file does not exist, the error message 'File not 
found’ is returned. If the file exists, it is processed according to 
the following list: 


OPTION 

PURPOSE 


0 

Off 

Ignore IBOOT at log-on 

1 

*LOAD 

IBOOT 

2 

*RUN 

IBOOT 

3 

*EXEC 

IBOOT 


OPTION 0 

This is set when a directory is created. It can be reset to this by 
entering the command: 

>*OPT 4,0 (or simply *OPT 4) 

> 

When set, no attempt is made to find the !BOOT file at log-on. 
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OPTION 1 


This is used to preset a part of memory at log-on. For example, a 
user may wish to load a special screen display. Another use for 
this is to load special-purpose machine language programs (e.g. a 
custom printer driver) into memory, at start-up. 

The following program shows an example (though trivial) of this: 

10 MODEO 

20 VDU 23, 128, &AA, &AA, &AA, &AA, &AA, &AA, 
&AA, &AA, 23,129, &FF, &FF, &FF, &FF, &FF, &FF, 
&FF, &FF 
30 PRINT 
40 FORJ = 1T015 

50 FOR I = 1 TO 80 : VDU 128 : NEXT I 
60 FORI = 1TO80: VDU129:NEXTI 
70 NEXTJ 

80 PRINT TAB(30,13); "THIS IS AN EXAMPLE” 

90 PRINT TAB(30,15); "OF A *LOAD OPERATION” 

100 PRINT TAB(30,17); "WHEN LOGGING-ON” 

110 *SAVE !BOOT FFFF3000 FFFF7FFF 

The program sets up a screen display in Mode 0 then saves a copy 
of the screen memory in a file called !BOOT. The load option is 
set, using the command: 

>*OPT 4,1 
> 


To demonstrate auto-load, ensure that your computer is display¬ 
ing Mode 0 then log-on again. If all of the steps have been 
followed correctly, the message should appear each time that you 
log-on. 

If not, check these points: 

• Check the auto-load option with the *C AT command. If it 
is not set to 1, re-enter the *OPT command. 

• Is there a file called !BOOT in your user root directory? 
You may have saved it in a subdirectory. 
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• Execute the command: 

>*INFO !BOOT 

!BOOT FFFF3000 FFFF3000 005000 

WR/ 12:10:83 OOOlCA 

> 

The last two fields (date and system internal name) will 
be different. All other information in your file should be 
the same. If it isn’t, check your Basic program. 


OPTION 2 

This allows machine language programs to be loaded into 
memory and then executed. We shall set up the DISCS utility 
from the library to demonstrate this. Begin by checking its load 
parameters: 

>*INFO $.LIBRARY.DISCS 

DISCS <load address> <execute address> <length> 
LR/R DD:MM:YY <system internal name> 

> 

Insert the values displayed for the load address, execute address 
and file length in the following commands: 

>*RENAME !BOOT SCREEN 
>*LOAD $.LIBRARY.DISCS 2000 

>*SAVE IBOOT 2000 + <length> 5 ^ 

>*OPT 4 2 <address> <address> 

The first command changes the name of the screen dump file from 
!BOOT to SCREEN so that it is not overwritten by the *SAVE 
command. The last command sets the boot option to load and 
execute the machine code program in the !BOOT file (alias 
DISCS) each time that you log-on. If something went wrong, 
compare the load parameters of DISCS and !BOOT using the 
*INFO command. Also, make sure that the boot option is set to 2 
by entering the *CAT command. 
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OPTION 3 

This is the last and most commonly used method of setting auto¬ 
load sequences. The !BOOT file contains text which is *EXECed 
as described in Chapter 3. This has two main advantages. First, it 
is easy to see what sequence of steps will be performed and then 
to change the sequence if required. Second, this option offers 
more versatility. While options 1 and 2 were restricted to one 
operation, any number of steps can be stored in an EXEC file. 
You will recall that the example for option 1 required the screen 
mode to be set to zero from the keyboard. Using option 3, this can 
be included as part of the command file. Start by BUILDing a text 
file named !BOOT. If your station does not have the *BUILD 
utility or a word processor, other methods of creating text files 
are described in Chapter 5. The text file should contain: 

MODE 0 
*LOAD SCREEN 

Set the EXEC option by entering the command: 

>*OPT 4,3 
> 

To ensure that all is well, start by changing to a different screen 
mode (e.g. MODE 7), then log-on again. You should now see the 
real possibilities of this facility. By combining the EXEC option 
with a text processor, you have the ability to execute almost any 
sequence of steps. 


AUTO START ON RESET 

There is still one feature of the auto-start facility to be discussed. 
This is the auto-boot operation for certain types of system reset. 
An auto-boot is simply an automatic log-on when the station is 
reset (e.g. when the BREAK key is pressed). If programmed to do 
so, the network filing system sends the command '*I AM BOOT’ 
to the file server. The file server treats this as a normal log-on, 
checking the USERID and then searching for a URD named 
!BOOT. After this the station will either ignore, *LOAD, *RUN 
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or *EXEC the file $.BOOT.!BOOT, depending on the value of the 
auto-load option. This feature allows disks to be set up with 
common start options for all users performing a specific task. 

The usual way to execute an auto-boot is with SHIFT-BREAK, 
that is, by holding down the SHIFT key. Press, then release the 
BREAK key. Do not release the SHIFT key until the screen 
clears and the first line of text appears (about one second). 

Note that the time required to execute the auto-load sequence can 
become quite significant, particularly if several stations are 
logging-on and the EXEC boot option is selected. After pressing 
SHIFT-BREAK, wait for the start sequence to execute. Do NOT 
press SHIFT-BREAK again as this increases the delay unneces¬ 
sarily. 

The conditions under which this facility is enabled are deter¬ 
mined by link 5 of the eight links on the keyboard’s printed 
circuit card. This is at the right-hand side of the space bar. To set 
a link, the keyboard must be removed and then a link or switch 
pack soldered in place. If unsure of the procedure, contact an 
approved service center. The links number from left to right. The 
options are as shown in Table A.l. 


Table A. 1 Switch Options 


RESET SEQUENCE 

BOOT OPTION 


Link 5 Open 

Link 5 Closed 

Power on 

Power on with CTRL 

Nil 

Auto-boot 

key pressed 

Power on with SHIFT 

Nil 

Auto-boot 

key pressed 

Power on with CTRL- 

Auto-boot 

Nil 

SHIFT pressed 

Auto-boot 

Nil 

BREAK 

Nil 

Auto-boot 

CTRL-BREAK 

Nil 

Auto-boot 

SHIFT-BREAK 

Auto-boot 

Nil 

CTRL-SHIFT-BREAK 

Auto-boot 

Nil 
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Link 5 is normally open. Thus the auto-boot facility is only 
enabled when the SHIFT key is pressed. If link 5 is set, press the 
BREAK key only. In this case, pressing the SHIFT key prevents 
the auto-boot sequence. 

Note: If the NFS is fitted to the station but is not selected on 
reset, the 'N’ key should be included in the key sequences 
described above. 



APPENDIX B 

HEXADECIMAL 

NOTATION 


Just as the houses in a street are referred to by a number, the 
basic unit of computer memory (the byte) is addressed in the 
same way. In the BBC Microcomputer, the operating system and 
filing systems use hexadecimal numbers when referring to 
memory addresses. This appendix explains the basics of this 
system. 

Perhaps it is because we have ten fingers and ten toes that we use 
decimal numbering. In the decimal system, all numbers are made 
by combining the ten digits from zero to nine (e.g. 1, 27, 
129768764231). Computers, on the other hand, use binary 
numbers because the electronics is simpler and more reliable 
than with other number systems. In the binary system, all 
numbers are made from the two digits 0 and 1. It is not difficult to 
design electronic circuits which are always off or on (0 or 1). A 
b3d;e consists of eight binary digits (bits). It may be any 
combination of eight zeros and ones (e.g. 00000000, 00101010, 
11010001,11111111). 

In a four-bit binary number (nibble) there are 16 possible 
combinations. 

As an exercise in mental arithmetic, conversion from decimal to 
binary and binary to decimal is not a simple matter (although the 
computer has no problem with it). When the Arabs developed 
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their numbering system (Arabic notation), they were not con¬ 
cerned with computer-compatible number systems. They created 
only ten symbols for counting: 

0123456789 

When working with computers, a number system which has 16 
symbols is easier to work with as it is easier to convert binary 
numbers. Base 16 notation is called hexadecimal. For hexadeci¬ 
mal numbering, we need another six symbols. 

For convenience, we use the first six letters of the alphabet. 

The full set becomes: 


BINARY 

DECIMAL 

HEXADECIMAL 

0000 

0 

0 

0001 

1 

1 

0010 

2 

2 

0011 

3 

3 

0100 

4 

4 

0101 

5 

5 

0110 

6 

6 

0111 

7 

7 

1000 

8 

8 

1001 

9 

9 

1010 

10 

A 

1011 

11 

B 

1100 

12 

C 

1101 

13 

D 

1110 

14 

E 

1111 

15 

F 


Consider the four examples of eight-bit binary numbers shown 
above. To convert them to hexadecimal, they must be split into 
two sets of four bits and then compared to the list above. In 
hexadecimal, they become: 

0000 0000 = 00 
0010 1010 = 2A 
1101 0001 = D1 
1111 1111 = FF 
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In the same way, a 16-bit memory address can be broken into four 
blocks of four bits and then converted into four hexadecimal 
numbers. Remember that these letters are only symbols, just the 
same as the Arabic characters. There are many texts which 
describe how to convert between binary, hexadecimal and 
decimal numbers. You do not need to be an expert in number 
systems but if you wish to use some of the system commands, you 
must have a basic understanding of bits, nibbles and bytes as well 
as memory addressing and hexadecimal notation. 


Fortunately, BBC Basic can translate between decimal and 
hexadecimal notation for you. For example, enter the following 


Basic commands: 


COMMAND 

RESULT 

PRINT ~ 15 

F 

PRINT ~ 1000 

3E8 

PRINT ~ 2 * 256 

200 

PRINT &F 

15 

PRINT &3E8 

1000 

PRINT &200 

512 

PRINT ~ &F 

F 

PRINT ~ &3E8 

3E8 

PRINT ~ 2 * &100 

200 


The tilde character (~) means 'display the following number in 
hexadecimal format’. The ampersand character (&) means 'what 
follows is a hexadecimal number’. The Basic interpreter always 
displays numbers in decimal notation, unless instructed other¬ 
wise. Also, it always assumes that numbers are decimal unless 
they are prefixed by the ampersand. 

If Basic is happy to work in decimal, what is the point of learning 
the hexadecimal system? The answer lies with the operating and 
filing systems. Many of their commands use hexadecimal nota¬ 
tion as this is more useful for memory addressing. Examine the 
memory map in the Appendix of the BBC Microcomputer User 
Guide. You will see that the addresses of the various blocks of 
memory are more logical in hexadecimal notation. The four main 
divisions start at &0, &4000, &8000 and &C000. In decimal, this 
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becomes 0, 16384, 32768 and 49152. Note that the ampersand 
character used in Basic statements does not precede numbers in 
operating system commands where numbers can only be repre¬ 
sented in hexadecimal. 

If you are not confident with hexadecimal notation, you should 
make the effort to learn it. Otherwise, learn how to use the BBC 
Microcomputer for number base conversions! 



APPENDIX C 
FILE HANDLING 
UTILITIES 


Chapter 5 introduced four utility programs which are included in 
the disk filing system. They are the BUILD, DUMP, LIST and 
TYPE utilities. If your workstation does not have access to them, 
the Basic programs described in this section perform the same 
tasks. Since this book is about networking (not Basic program¬ 
ming), there is no description of the programs. However, most 
variables have meaningful names and the programs are reasona¬ 
bly structured. It could be a useful exercise to examine the 
techniques used. 

To create your own copies, type in each program in turn and save 
it with its respective filename, for example, SAVE "BUILD”. To 
load and run the same program, enter the command CHAIN 
"BUILD”. Remember to type 'NEW’ and then 'AUTO’ before 
entering each program. After t 5 q)ing in the program, press 
'Escape’ to exit the AUTO program entry mode. Blank program 
lines are entered by typing one space before the carriage return. 
Spaces following the line number on lines which include 
statements are produced by listing the program after entering 
the 'LISTO 7’ command. Indenting is used here to aid clarity. 
Except for blank lines (as described above), do not type spaces at 
the start of any line. 

Note: These programs will overwrite any Basic program in 
memory. 
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PROGRAM 1 


10 REM BUILD UTILITY 
20 
30 

40 ON ERROR GOTO 250 
50 

60 return = 13 : linefeed = 10 :lcount = 0 : ccount = 0 
@% = &0102040A 

70 delete = &7F : escape = 17 : lineno = .0001: 

buflen = 500 
80 DIM buffer buflen 
90 

100 REPEAT 

110 PRINT RIGHT$(STR$(lineno),4);" 

120 REPEAT 
130 char = GET 

140 IF Icount = 255 THEN PROCfull 

150 IF char = delete THEN PROCdelete 

ELSE PROCsend 
160 VDU char 

170 UNTIL char = return 

180 lineno = lineno + .0001 
190 UNTIL ccount = buflen -1 
200 

210 PRINT' "Buffer full” : PROCsave 

220 @% = &90A:END 

230 

240 REM Error handler 

250 REPORT : IF ERR <> 17 THEN 280 

260 PRINT 

270 IF ccount <> 0 THEN PROCsave 

280 @% = &90A:END 

290 

300 DEF PROCsave 

310 INPUT'"Enter filename ”file$ 

320 file = OPENOUT file$ 

330 FOR i = 0 TO ccount -1 
340 BPUT# file,(buffer?!) 

350 NEXT i 
360 CLOSE# file 
370 *FX15 



380 ENDPROC 
390 

400 DEF PROCdelete 

410 IF Icount = 0 THEN char = 7 : ENDPROC 

420 ccount = ccount -1 

430 Icount = Icount -1 

440 ENDPROC 

450 

460 DEF PROCsend 
470 buffer?ccount = char 
480 Icount = Icount + 1 
490 ccount = ccount + 1 

500 IF char = return THEN VDU linefeed: Icount = 0 

510 ENDPROC 

520 

530 DEF PROCfull 
540 test = FALSE 
550 REPEAT 

560 IF (char = delete) OR (char = return) THEN 
test = TRUE ELSE VDU 7 : char = GET 
570 UNTIL test = TRUE 

580 ENDPROC 


PROGRAM 2 

10 REM DUMP UTILITY 
20 
30 

40 ON ERROR GOTO 290 
50 

60 escape = 17 : lineno = .0000 : @% = &:0102040A 
70 

80 INPUT "Enter filename ” file$ 

90 file = OPENIN file$ 

100 

110 REPEAT 

120 @% = &0102040A 

130 PRINT RIGHT$(STR$(lineno),4);" 

140 @% = 1 
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150 epos = VPOS 

160 FOR i = 1 TO 8 

170 char = BGET# file 

180 IF char < 16 THEN PRINT"0”; 

190 PRINT-char;" 

200 Ipos = POS 

210 VDU31,28+i,cpos 

220 IF (char >31 AND char <127) THEN 

VDU char ELSE VDU 46 
230 VDU 31,Ipos,epos 

240 NEXT i 

250 lineno = lineno + .0008 
260 PRINT 
270 UNTIL FALSE 
280 

290 IF ERR = 223 THEN PROCend ELSE PRINT: 

REPORT 
300 PRINT 
310 CLOSE# file 
320 @% = &90A 
330 END 
340 

350 DEF PROCend 
360 FORj = i TO 8 
370 PRINT"** 

380 Ipos = POS 

390 VDU 31,28+j,cpos,46,31,lpos,cpos 
400 NEXTj 
410 ENDPROC 


PROGRAM 3 

10 REM LIST UTILITY 
20 
30 

40 ON ERROR REPORT: GOTO 220 
50 

60 return = 13 : linefeed = 10 : @% = &0102040A 
70 escape = 17 : lineno = .0001 
80 
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90 INPUT "Enter filename ”file$ 

100 file = OPENIN file$ 

110 

120 REPEAT 

130 PRINT RIGHT$(STR$(lineno),4);" 

140 REPEAT 

150 char = BGET# file 

160 IF char <> linefeed THEN VDU char 

170 IF char = return THEN VDU linefeed 

180 UNTIL char = return 

190 lineno = lineno + .0001 

200 UNTIL EOF# file 

210 

220 PRINT 
230 CLOSE# 0 
240 @% = &90A 
250 END 


PROGRAM 4 

10 REM TYPE UTILITY 
20 

30 ON ERROR PRINT: REPORT: GOTO 170 
40 

50 return = 13 : linefeed = 10 : @% = &0102040A 
60 escape = 17 : lineno = .0001 
70 

80 INPUT "Enter filename ”file$ 

90 file = OPENIN file$ 

100 

110 REPEAT 

120 char = BGET# file 

130 IF char <> linefeed THEN VDU char 

140 IF char = return THEN VDU linefeed 

150 UNTIL EOF# file 

160 

170 PRINT 
180 CLOSE# file 
190 @% = &90A 
200 END 
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